ObjectDataSource.Select Метод

Определение

Извлекает данные из базового хранилища данных, вызвав метод, указанный в свойстве SelectMethod, с параметрами, заданными в коллекции SelectParameters.Retrieves data from the underlying data storage by calling the method that is identified by the SelectMethod property with the parameters in the SelectParameters collection.

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

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

IEnumerable

Список строк данных IEnumerable.An IEnumerable list of data rows.

Примеры

Пример кода см. в разделе ObjectDataSource.For a code example, see ObjectDataSource.

Комментарии

Указанный метод может иметь любую сигнатуру метода, но он должен возвращать или быть производным от одного из типов, перечисленных в следующей таблице, ObjectDataSource чтобы элемент управления мог успешно его вызвать.The specified method might have any method signature, but it must return or be derived from one of the types listed in the following table for the ObjectDataSource control to call it successfully.

Возвращаемый типReturn type ДействиеAction
IEnumerable IEnumerable Select Метод возвращается методом.The IEnumerable is returned by the Select method.
DataTable Объект DataView создается с помощью DataTable и возвращается Select методом.A DataView is created by using the DataTable and returned by the Select method.
DataView DataView Select Метод возвращается методом.The DataView is returned by the Select method.
DataSet Первый DataTable из DataSet извлекается и DataView создается и возвращается Select методом.The first DataTable of the DataSet is extracted and a DataView is created and returned by the Select method.
Object Объект упаковывается в коллекцию с одним элементом IEnumerable и возвращается Select методом.The object is wrapped in a one-element IEnumerable collection and returned by the Select method.

Метод, идентифицируемый SelectMethod свойством, может быть методом экземпляра или static Shared методом (в Visual Basic).The method that is identified by the SelectMethod property can be an instance method or a static (Shared in Visual Basic) method. Если это метод экземпляра, бизнес-объект создается и уничтожается каждый раз, когда вызывается метод, заданный SelectMethod свойством, за исключением того, что тот же экземпляр используется для вызова метода, указанного SelectMethod свойством, и метода, указанного SelectCountMethod свойством.If it is an instance method, the business object is created and destroyed each time the method that is specified by the SelectMethod property is called, except that the same instance is used to call the method that is specified by the SelectMethod property and the method that is specified by the SelectCountMethod property. SelectМетод возвращает IEnumerable интерфейс.The Select method returns an IEnumerable interface. Однако, чтобы включить сценарии кэширования и фильтрации, возвращаемое значение должно быть DataSet объектом.However, to enable caching and filtering scenarios, the return value must be a DataSet object. Хотя DataSet класс не реализует IEnumerable интерфейс, ObjectDataSource элемент управления автоматически извлекает элемент управления по умолчанию DataView , который реализует IEnumerable .While the DataSet class does not implement the IEnumerable interface, the ObjectDataSource control automatically extracts the default DataView control, which implements the IEnumerable.

Перед выполнением Select операции OnSelecting вызывается метод для вызова Selecting события.Before the Select operation is performed, the OnSelecting method is called to raise the Selecting event. Можно обработать событие, Selecting чтобы проверить значения параметров и выполнить предварительную обработку перед Select операцией.You can handle the Selecting event to examine the values of the parameters and to perform any preprocessing before a Select operation. Для выполнения операции получения данных ObjectDataSourceView объект использует отражение для создания экземпляра объекта, определяемого TypeName свойством.To perform a data retrieval operation, the ObjectDataSourceView object uses reflection to create an instance of the object that is identified by the TypeName property. Затем он вызывает метод, идентифицируемый SelectMethod свойством, используя любые связанные SelectParameters Свойства.It then calls the method that is identified by the SelectMethod property, using any associated SelectParameters properties. После Select завершения операции OnSelected вызывается метод для вызова Selected события.After the Select operation completes, the OnSelected method is called to raise the Selected event. Событие можно обработать Selected для проверки любых возвращаемых значений, выходных параметров и исключений, а также для выполнения любой последующей обработки.You can handle the Selected event to examine any return values, output parameters, and exceptions, and to perform any post-processing.

Если SelectMethod свойство возвращает DataSet DataTable объект, или DataView включено кэширование, ObjectDataSource извлекает данные из кэша и сохраняет их во время Select операции.If the SelectMethod property returns a DataSet, DataTable, or DataView object and caching is enabled, the ObjectDataSource retrieves data from and saves data to the cache during the Select operation. Кэш создается, удаляется или обновляется в зависимости от поведения кэширования, заданного сочетанием CacheDuration CacheExpirationPolicy свойств и.The cache is created, discarded, or refreshed based on the caching behavior that is specified by the combination of the CacheDuration and CacheExpirationPolicy properties.

Если SelectMethod свойство возвращает DataSet DataTable объект или, а FilterExpression свойство было задано, то оно вычисляется с любыми предоставленными FilterParameters свойствами, а результирующий фильтр применяется к списку данных во время Select операции.If the SelectMethod property returns a DataSet or DataTable object, and a FilterExpression property has been specified, it is evaluated with any supplied FilterParameters properties and the resulting filter is applied to the list of data during the Select operation.

SelectМетод делегирует Select методу объекта ObjectDataSourceView , связанного с ObjectDataSource элементом управления.The Select method delegates to the Select method of the ObjectDataSourceView that is associated with the ObjectDataSource control.

Дополнительные сведения о слиянии параметров, времени существования объектов и разрешении методов см. в разделе SelectMethod .For more information about parameter merging, object lifetime, and method resolution, see SelectMethod.

Элементы управления с привязкой к даннымData-Bound Controls

Если ObjectDataSource элемент управления связан с элементом управления с привязкой к данным, таким как GridView элемент управления, нет необходимости вызывать Select метод из кода страницы.When the ObjectDataSource control is associated with a data-bound control, such as the GridView control, it is not necessary to call the Select method from page code. SelectВместо этого метод вызывается непосредственно элементом управления с привязкой к данным.The Select method is invoked directly by the data-bound control instead.

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

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