DynamicFilterExpression DynamicFilterExpression DynamicFilterExpression DynamicFilterExpression Class

Определение

Изменяет запрос к базе данных с помощью значения из указанного фильтра элемента управления.Modifies a database query by using a value from specified filter control.

public ref class DynamicFilterExpression : System::Web::UI::WebControls::Expressions::DataSourceExpression
public class DynamicFilterExpression : System.Web.UI.WebControls.Expressions.DataSourceExpression
type DynamicFilterExpression = class
    inherit DataSourceExpression
Public Class DynamicFilterExpression
Inherits DataSourceExpression
Наследование
DynamicFilterExpressionDynamicFilterExpressionDynamicFilterExpressionDynamicFilterExpression

Примеры

В следующем примере показано, как использовать DynamicFilterExpression элемент управления для выбора шаблона фильтра на странице.The following example shows how to use the DynamicFilterExpression control to select a filter template in a page. Шаблон фильтра выбирается DynamicFilter элементом управления, DynamicFilterExpression идентифицируемым элементом управления через его ControlID свойство.The filter template is selected by the DynamicFilter control that is identified by DynamicFilterExpression control through its ControlID property.

<asp:QueryExtender ID="QueryExtender1"   
    TargetControlID="GridDataSource" runat="server">  
    <asp:DynamicFilterExpression ControlID="CategoryFilterID" />  
</asp:QueryExtender>  

Комментарии

Класс позволяет изменить запрос к базе данных, используя значения, назначенные DynamicFilter в элементе управления. DynamicFilterExpressionThe DynamicFilterExpression class enables you to modify a database query using the values that are assigned in a DynamicFilter control. Этот элемент управления делегирует задачу создания IQueryable запроса специализированному элементу управления, QueryableFilterRepeater например элементу управления DynamicFilter или элементу управления.This control delegates the task of building of the IQueryable query to a specialized control such as QueryableFilterRepeater control or DynamicFilter control.

Элементы управления фильтра, в свою очередь, делегируют сборку запроса шаблону фильтра, на который они ссылаются.The filter controls in turn delegate the building of the query to the filter template that they reference. Затем запрос выполняется элементом управления источника данных, на который ссылается QueryExtender элемент управления.The query is then executed by the data source control that is referenced by the QueryExtender control.

Чтобы использовать DynamicFilterExpression класс на странице, выполните следующие действия.To use the DynamicFilterExpression class in a page, you follow these steps:

  • Добавьте на страницу элемент управления. QueryExtenderAdd a QueryExtender control to the page.

  • TargetControlID Задайте свойство QueryExtender элемента управления для ссылки на элемент управления источника данных.Set the TargetControlID property of the QueryExtender control to reference the data source control.

  • Добавьте объект в качестве дочернего элемента QueryExtender для элемента управления. DynamicFilterExpressionAdd a DynamicFilterExpression object as a child of the QueryExtender control.

  • ControlID Установите свойство DynamicFilterExpression объекта, чтобы оно ссылалось на элемент управления фильтра.Set the ControlID property of the DynamicFilterExpression object to reference the filter control.

В предыдущих шагах предполагается, что на странице определены связанные элементы управления фильтра, элементы управления с привязкой к данным и элемент управления источниками данных.In the previous steps it is assumed that the related filter controls, data-bound controls, and data source control are defined in the page.

Конструкторы

DynamicFilterExpression() DynamicFilterExpression() DynamicFilterExpression() DynamicFilterExpression()

Инициализирует новый экземпляр класса DynamicFilterExpression.Initializes a new instance of the DynamicFilterExpression class.

Свойства

Context Context Context Context

Получает экземпляр HttpContext элемента-владельца.Gets the HttpContext instance of the owner control.

(Inherited from DataSourceExpression)
ControlID ControlID ControlID ControlID

Получает или задает идентификатор фильтра элемента управления.Gets or sets the filter control identifier.

DataSource DataSource DataSource DataSource

Получает объект источника данных, связанный с элементом-владельцем.Gets the data source object that is associated with the owner control.

(Inherited from DataSourceExpression)
IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState

Будучи реализован классом, получает значение, указывающее, отслеживает ли объект выражения источника данных изменения в своем состоянии представления.When implemented by a class, gets a value that indicates whether a data source expression object is tracking its view state changes.

(Inherited from DataSourceExpression)
IsTrackingViewState IsTrackingViewState IsTrackingViewState IsTrackingViewState

Получает значение, указывающее, отслеживает ли объект выражения источника данных изменения в своем состоянии представления.Gets a value that indicates whether a data source expression object is tracking its view state changes.

(Inherited from DataSourceExpression)
Owner Owner Owner Owner

Получает элемент-владелец.Gets the owner control.

(Inherited from DataSourceExpression)
ViewState ViewState ViewState ViewState

Получает экземпляр класса StateBag, содержащий сведения о текущем состоянии представления.Gets an instance of the StateBag class that contains the current view state information.

(Inherited from DataSourceExpression)

Методы

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetQueryable(IQueryable) GetQueryable(IQueryable) GetQueryable(IQueryable) GetQueryable(IQueryable)

Получает измененный запрос с помощью текущего значения фильтра.Gets the modified query using the current filter value.

GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
LoadViewState(Object) LoadViewState(Object) LoadViewState(Object) LoadViewState(Object)

Загружает в объект DataSourceExpression состояние значений, которое необходимо сохранить.Loads the state of the values in the DataSourceExpression object that must be persisted.

(Inherited from DataSourceExpression)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
SaveViewState() SaveViewState() SaveViewState() SaveViewState()

Сохраняет текущее состояние просмотра объекта DataSourceExpression.Saves the current view state of the DataSourceExpression object.

(Inherited from DataSourceExpression)
SetContext(Control, HttpContext, IQueryableDataSource) SetContext(Control, HttpContext, IQueryableDataSource) SetContext(Control, HttpContext, IQueryableDataSource) SetContext(Control, HttpContext, IQueryableDataSource)

Инициализирует выражение сведениями об источнике данных.Initializes the expression with data source information.

SetDirty() SetDirty() SetDirty() SetDirty()

Помечает объект DataSourceExpression для сохранения его состояния в состоянии просмотра.Marks the DataSourceExpression object so that its state will be saved in view state.

(Inherited from DataSourceExpression)
ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)
TrackViewState() TrackViewState() TrackViewState() TrackViewState()

Отслеживает изменения состояния представления объекта DataSourceExpression, позволяя сохранять их в объекте StateBag для объекта выражения источника данных.Tracks view state changes of the DataSourceExpression object so that the changes can be stored in the StateBag object for the data source expression object.

(Inherited from DataSourceExpression)

Явные реализации интерфейса

IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object)

Будучи реализован классом, загружает ранее сохраненное состояние представления объекта выражения источника данных.When implemented by a class, loads the previously saved view state of the data source expression object.

(Inherited from DataSourceExpression)
IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState()

Будучи реализован классом, сохраняет текущее состояние просмотра объекта DataSourceExpression.When implemented by a class, saves the current view state of the DataSourceExpression object.

(Inherited from DataSourceExpression)
IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState()

Будучи реализован классом, отслеживает изменения состояния представления объекта DataSourceExpression, позволяя сохранять их в объекте StateBag для объекта выражения источника данных.When implemented by a class, tracks view state changes of the DataSourceExpression object so that the changes can be stored in the StateBag object for the data source expression object.

(Inherited from DataSourceExpression)

Применяется к

Дополнительно