DataSourceSelectArguments Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет механизм, используемый элементом управления, связанным с данными, для запроса операций над данными из элемента управления источника данных после извлечения данных. Этот класс не наследуется.
public ref class DataSourceSelectArguments sealedpublic sealed class DataSourceSelectArgumentstype DataSourceSelectArguments = classPublic NotInheritable Class DataSourceSelectArguments- Наследование
-
DataSourceSelectArguments
Комментарии
Элементы управления с привязкой к данным используют DataSourceSelectArguments класс , чтобы запросить, чтобы элемент управления источником данных выполнял дополнительные операции, связанные с данными, в результирующем наборе, например сортировку данных или возврат определенного подмножества данных. Эти операции, связанные с данными, перечисляются перечислением DataSourceCapabilities . В следующей таблице показано, как DataSourceSelectArguments класс поддерживает эти операции, связанные с данными.
| Функция | Связанные свойства DataSourceSelectArguments |
|---|---|
| DataSourceCapabilities.Sort | SortExpression |
| DataSourceCapabilities.Page | StartRowIndex, MaximumRows |
| DataSourceCapabilities.RetrieveTotalRowCount | RetrieveTotalRowCount, TotalRowCount |
Элементы управления с привязкой к данным явно вызывают PerformSelect метод для привязки данных, который вызывает Select(DataSourceSelectArguments, DataSourceViewSelectCallback) метод элемента управления источником данных, с которым они связаны. Таким образом, элемент управления с привязкой к данным извлекает данные из элемента управления "Источник данных" по запросу. Select(DataSourceSelectArguments, DataSourceViewSelectCallback) Так как метод принимает параметр, элемент управления с привязкой DataSourceSelectArguments к данным отвечает за создание объекта и управление DataSourceSelectArguments им и его передачу методу Select(DataSourceSelectArguments, DataSourceViewSelectCallback) при извлечении данных из элемента управления источником данных.
В некоторых случаях элементам управления с привязкой к данным может не потребоваться никаких дополнительных возможностей, связанных с данными. В этом случае элементы управления с привязкой к данным передают Empty объект arguments в Select(DataSourceSelectArguments, DataSourceViewSelectCallback) метод .
Для отсортированных результирующих наборов элементы управления с привязкой к данным проверка свойство представления CanSort источника данных во время выполнения и добавить DataSourceCapabilities.Sort возможность с помощью AddSupportedCapabilities(DataSourceCapabilities) метода . В качестве отдельной операции элемент управления с привязкой к данным может запросить отсортированный результирующий набор из элемента управления источником данных, задав SortExpression свойство DataSourceSelectArguments объекта, переданного методу Select(DataSourceSelectArguments, DataSourceViewSelectCallback) .
Для сценариев разбиения на страницы элементы управления с привязкой к данным проверка свойство представления CanPage источника данных во время выполнения и добавить DataSourceCapabilities.Page возможность с помощью AddSupportedCapabilities(DataSourceCapabilities) метода . В качестве отдельной операции элемент управления с привязкой к данным может запросить подмножество данных из элемента управления источником данных для разбиения по страницам, задав StartRowIndex свойства и MaximumRows для объекта, DataSourceSelectArguments передаваемого Select(DataSourceSelectArguments, DataSourceViewSelectCallback) в метод .
Чтобы получить общее количество строк для сценариев разбиения на страницы, элементы управления с привязкой к данным проверка свойство представления CanRetrieveTotalRowCount источника данных во время выполнения и добавить DataSourceCapabilities.RetrieveTotalRowCount возможность с помощью AddSupportedCapabilities(DataSourceCapabilities) метода . В качестве отдельной операции элемент управления с привязкой к данным может запросить общее количество строк из элемента управления источником данных для разбиения по DataSourceSelectArguments страницам, задав RetrieveTotalRowCount свойство объекта, передаваемого методуSelect(DataSourceSelectArguments, DataSourceViewSelectCallback). При возврате Select(DataSourceSelectArguments, DataSourceViewSelectCallback) метода общее число строк содержится в свойстве TotalRowCount .
Важно!
Если задано какое-либо из DataSourceSelectArguments свойств, но текущий привязанный элемент управления источником данных не поддерживает запрошенную InvalidOperationException возможность, при вызове DataSourceSelectArguments.RaiseUnsupportedCapabilitiesError(DataSourceView) метода возникает исключение.
Конструкторы
| DataSourceSelectArguments() |
Инициализирует новый экземпляр по умолчанию класса DataSourceSelectArguments. |
| DataSourceSelectArguments(Int32, Int32) |
Инициализирует новый экземпляр класса DataSourceSelectArguments с указанной стартовой позицией и числом строк, которые возвращаются для скриптов разбиения по страницам. |
| DataSourceSelectArguments(String) |
Инициализирует новый экземпляр класса DataSourceSelectArguments с заданным условием сортировки. |
| DataSourceSelectArguments(String, Int32, Int32) |
Инициализирует новый экземпляр класса DataSourceSelectArguments с указанным выражением сортировки, стартовой позицией и числом строк, которые возвращаются для скриптов разбиения по страницам. |
Свойства
| Empty |
Возвращает объект DataSourceSelectArguments с выражением сортировки, заданным в Empty. |
| MaximumRows |
Возвращает или задает значение, представляющее максимальное число строк данных, которые возвращаются элементом управления источником данных для операции по извлечению данных. |
| RetrieveTotalRowCount |
Возвращает или задает значение, указывающее, извлекает ли элемент управления источником данных общее число строк в процессе операции по извлечению данных. |
| SortExpression |
Возвращает или задает выражение, которое представление источника данных использует для сортировки данных, извлеченных методом Select(DataSourceSelectArguments, DataSourceViewSelectCallback). |
| StartRowIndex |
Возвращает или задает значение, представляющее начальную позицию, которую использует элемент управления источника данных при извлечении строк в процессе операции по извлечению данных. |
| TotalRowCount |
Возвращает или задает число строк, которые извлекаются в процессе операции по извлечению данных. |
Методы
| AddSupportedCapabilities(DataSourceCapabilities) |
Добавляет одну возможность экземпляру DataSourceSelectArguments, используемому для сравнения поддерживаемых и запрошенных возможностей. |
| Equals(Object) |
Определяет, равен ли указанный экземпляр DataSourceSelectArguments текущему экземпляру. |
| GetHashCode() |
Возвращает хэш-код для типа DataSourceSelectArguments. |
| GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
| MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
| RaiseUnsupportedCapabilitiesError(DataSourceView) |
Сравнивает возможности, запрошенные для операции ExecuteSelect(DataSourceSelectArguments), с возможностями, поддерживаемыми указанным представлением источника данных. |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
