DynamicFilterExpression Класс

Определение

Изменяет запрос к базе данных с помощью значения из указанного фильтра элемента управления.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
Наследование
DynamicFilterExpression

Примеры

В следующем примере показано, как использовать 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.Initializes a new instance of the DynamicFilterExpression class.

Свойства

Context

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

(Унаследовано от DataSourceExpression)
ControlID

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

DataSource

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

(Унаследовано от DataSourceExpression)
IsTrackingViewState

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

(Унаследовано от DataSourceExpression)
Owner

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

(Унаследовано от DataSourceExpression)
ViewState

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

(Унаследовано от DataSourceExpression)

Методы

Equals(Object)

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

(Унаследовано от Object)
GetHashCode()

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

(Унаследовано от Object)
GetQueryable(IQueryable)

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

GetType()

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

(Унаследовано от Object)
LoadViewState(Object)

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

(Унаследовано от DataSourceExpression)
MemberwiseClone()

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

(Унаследовано от Object)
SaveViewState()

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

(Унаследовано от DataSourceExpression)
SetContext(Control, HttpContext, IQueryableDataSource)

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

SetDirty()

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

(Унаследовано от DataSourceExpression)
ToString()

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

(Унаследовано от Object)
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.

(Унаследовано от DataSourceExpression)

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

IStateManager.IsTrackingViewState

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

(Унаследовано от DataSourceExpression)
IStateManager.LoadViewState(Object)

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

(Унаследовано от DataSourceExpression)
IStateManager.SaveViewState()

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

(Унаследовано от DataSourceExpression)
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.

(Унаследовано от DataSourceExpression)

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

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