ControlFilterExpression ControlFilterExpression ControlFilterExpression ControlFilterExpression Class

Определение

Изменяет запрос к базе данных, используя ключ данных элемента, выбранного в элементе управления с привязкой к данным.Modifies a database query by using the data key of the item that is selected in a data-bound control.

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

Примеры

В следующем примере показано, как использовать ControlFilterExpression класс для ссылки на исходный элемент управления с привязкой к данным, в котором выбран ключ данных.The following example shows how to use the ControlFilterExpression class to reference a source data-bound control, where the data key is selected. QueryExtender Элемент управления указывает на целевой элемент управления источника данных, который получает данные, отфильтрованные с помощью выбранного ключа данных.The QueryExtender control points to a target data source control that obtains data that is filtered by using the selected data key. В примере исходный элемент управления с привязкой к данным ссылается на родительскую таблицу, а целевой элемент управления с привязкой к данным ссылается на дочернюю таблицу.In the example, the source data-bound control references a parent table and the target data-bound control references a child table.

<asp:QueryExtender ID="QueryExtenderID"   
    TargetControlID="TargetDataSourceID" runat="server">  
    <asp:ControlFilterExpression ControlID="SourceGridViewID" />  
</asp:QueryExtender>  

Комментарии

Класс, предназначенный для использования в том случае, если страница содержит два элемента управления с привязкой к GridView данным, такие ListView как элемент управления и элемент управления. ControlFilterExpressionThe ControlFilterExpression class that is designed to be used when a page contains two data-bound controls such as a GridView control and a ListView control. Одним элементом управления является источник, в котором выбран ключ данных (строка).One control is the source, where a data key (row) is selected. Другой элемент управления — это целевой объект, в котором отображаются данные на основе выбранного ключа данных.The other control is the target where the data is displayed based on the selected data key. Целевые данные получаются элементом управления источника данных, который выполняет запрос, определенный в QueryExtender классе и построенный с помощью выбранного ключа данных.The target data is obtained by a data source control that executes the query that is defined in the QueryExtender class and that is built by using the selected data key.

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

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

  • Присвойте QueryExtender свойству элемента управления идентификатор целевого элемента управления источника данных. TargetControlIDSet the TargetControlID property of the QueryExtender control to the ID of the target data source control.

  • ControlFilterExpression Добавьте экземплярQueryExtender в элемент управления.Add a ControlFilterExpression instance to the QueryExtender control.

  • Присвойте ControlFilterExpression свойству элемента исходный элемент управления с привязкой к данным. ControlIDSet the ControlID property of the ControlFilterExpression element to the source data-bound control.

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

ControlFilterExpression() ControlFilterExpression() ControlFilterExpression() ControlFilterExpression()

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

Свойства

Column Column Column Column

Получает или задает имя столбца, на котором основан запрос.Gets or sets the name of the column that the query is based on.

Context Context Context Context

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

(Inherited from DataSourceExpression)
ControlID ControlID ControlID ControlID

Получает или задает идентификатор исходного элемента управления с привязкой к данным.Gets or sets the ID of the source data-bound control.

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 data source query to modify.

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

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

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

Восстанавливает сохраненное раннее состояние представления.Restores the previously saved view state.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

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

Сохраняет изменения состояния представления с того момента, как страница была отправлена на сервер.Saves the changes to view state since the time the page was posted to the server.

SetContext(Control, HttpContext, IQueryableDataSource) SetContext(Control, HttpContext, IQueryableDataSource) SetContext(Control, HttpContext, IQueryableDataSource) SetContext(Control, HttpContext, IQueryableDataSource)

Инициализирует выражение фильтра сведениями об источнике данных.Initializes the filter 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()

Инициирует отслеживание объектом ControlFilterExpression изменений в состоянии его представления, благодаря чему эти изменения можно сохранить в объекте состояния просмотра элемента управления и хранить их для всех запросов одной и той же страницы.Causes the ControlFilterExpression object to track changes to its view state so they can be stored in the control's view state object and to be persisted across requests for the same page.

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

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)

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

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