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.
Перед выполнением SelectOnSelecting операции вызывается метод для вызова Selecting события . Событие можно обработать Selecting для проверки значений параметров и выполнения любой предварительной обработки перед операцией Select . Для выполнения операции ObjectDataSourceView извлечения данных объект использует отражение для создания экземпляра объекта, который определяется свойством TypeName . Затем он вызывает метод, который идентифицируется свойством SelectMethod , используя все связанные SelectParameters свойства. Select После завершения операции вызывается метод для OnSelected вызова Selected события . Вы можете обработать Selected событие для проверки любых возвращаемых значений, выходных параметров и исключений, а также для выполнения постобработки.
SelectMethod Если свойство возвращает DataSetобъект , DataTableили DataView и кэширование ObjectDataSource включено, объект извлекает данные из и сохраняет их в кэше во время Select операции. Кэш создается, удаляется или обновляется в зависимости от поведения кэширования, заданного CacheDuration сочетанием свойств и CacheExpirationPolicy .
SelectMethod Если свойство возвращает DataSet объект или DataTable и FilterExpression свойство задано, оно вычисляется с любыми предоставленными FilterParameters свойствами, а полученный фильтр применяется к списку данных во время Select операции.
Метод Select делегирует Select методу объекта , ObjectDataSourceView связанного с элементом ObjectDataSource управления .
Дополнительные сведения о слиянии параметров, времени существования объекта и разрешении методов см. в разделе SelectMethod.
Элементы управления с привязкой к данным
ObjectDataSource Если элемент управления связан с элементом управления с привязкой к данным, например с элементом GridView управления , нет необходимости вызывать Select метод из кода страницы. Вместо Select этого метод вызывается непосредственно элементом управления с привязкой к данным.
