ObjectDataSource.Select Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Извлекает данные из базового хранилища данных, вызывая метод, который определяется SelectMethod свойством с параметрами SelectParameters в коллекции.
public:
System::Collections::IEnumerable ^ Select();public System.Collections.IEnumerable Select();member this.Select : unit -> System.Collections.IEnumerablePublic Function Select () As IEnumerableВозвращаемое значение
IEnumerable Список строк данных.
Примеры
Пример кода см. в разделе ObjectDataSource.
Комментарии
Указанный метод может иметь любую сигнатуру метода, но он должен возвращать или быть производным от одного из типов, перечисленных в следующей таблице для ObjectDataSource успешного вызова элемента управления.
| Тип возвращаемого значения | Действие |
|---|---|
| IEnumerable | Возвращается IEnumerable методом Select . |
| DataTable | Объект DataView создается с помощью DataTable метода и возвращается Select . |
| DataView | Возвращается DataView методом Select . |
| DataSet | Первая DataTable из DataSet них извлекается и DataView создается и возвращается методом Select . |
| Object | Объект упаковывается в коллекцию одного элемента IEnumerable и возвращается методом Select . |
Метод, который определяется свойством SelectMethod , может быть методом экземпляра или static методом (Shared в Visual Basic). Если это метод экземпляра, бизнес-объект создается и уничтожается каждый раз при вызове метода, указанного SelectMethod свойством, за исключением того, что тот же экземпляр используется для вызова метода, указанного свойством, и метода, указанного SelectMethod свойством SelectCountMethod . Метод Select возвращает IEnumerable интерфейс. Тем не менее, чтобы включить кэширование и фильтрацию сценариев, возвращаемое значение должно быть DataSet объектом.
DataSet Хотя класс не реализует IEnumerable интерфейс, ObjectDataSource элемент управления автоматически извлекает элемент управления по умолчаниюDataView, который реализует этот интерфейсIEnumerable.
Select Перед выполнением OnSelecting операции вызывается метод для вызова Selecting события. Событие можно обрабатывать Selecting для проверки значений параметров и выполнения любой предварительной обработки перед операцией Select . Для выполнения операции ObjectDataSourceView извлечения данных объект использует отражение для создания экземпляра объекта, определяемого свойством TypeName . Затем он вызывает метод, который определяется свойством SelectMethod , используя все связанные SelectParameters свойства. Select После завершения OnSelected операции вызывается метод для вызова Selected события. Событие можно обрабатывать Selected для проверки любых возвращаемых значений, выходных параметров и исключений, а также для выполнения любой последующей обработки.
SelectMethod Если свойство возвращает DataSetDataTableобъект или DataView объект и кэширование, ObjectDataSource извлекает данные из кэша Select и сохраняет данные в кэш во время операции. Кэш создается, удаляется или обновляется на основе поведения кэширования, указанного CacheDuration сочетанием свойств и CacheExpirationPolicy свойств.
SelectMethod Если свойство возвращает DataSet объект или DataTable объект, а FilterExpression свойство указано, оно вычисляется с любыми предоставленными FilterParameters свойствами, а результирующий фильтр применяется к списку данных во время Select операции.
Метод Select делегирует Select методу, связанному ObjectDataSourceView с элементом ObjectDataSource управления.
Дополнительные сведения о слиянии параметров, времени существования объекта и разрешении методов см. в разделе SelectMethod.
элементы управления Data-Bound
ObjectDataSource Если элемент управления связан с элементом управления с привязкой к данным, например GridView элементом управления, не требуется вызывать Select метод из кода страницы. Вместо Select этого метод вызывается непосредственно элементом управления с привязкой к данным.
