ObjectDataSource.Select Метод

  • Ссылка

Определение

Пространство имен:
System.Web.UI.WebControls
Сборка:
System.Web.dll

Извлекает данные из базового хранилища данных, вызвав метод, указанный в свойстве SelectMethod, с параметрами, заданными в коллекции SelectParameters.

public:
 System::Collections::IEnumerable ^ Select();
public System.Collections.IEnumerable Select ();
member this.Select : unit -> System.Collections.IEnumerable
Public Function Select () As IEnumerable

Возвращаемое значение

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 этого метод вызывается непосредственно элементом управления с привязкой к данным.

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

См. также раздел