ObjectDataSource.Select Metoda

Definicja

Pobiera dane z podstawowego magazynu danych przez wywołanie metody, która jest identyfikowana przez SelectMethod Właściwość z parametrami w SelectParameters kolekcji.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

Zwraca

IEnumerable

IEnumerableLista wierszy danych.An IEnumerable list of data rows.

Przykłady

Aby zapoznać się z przykładowym kodem, zobacz ObjectDataSource .For a code example, see ObjectDataSource.

Uwagi

Określona metoda może mieć dowolny podpis metody, ale musi zwrócić lub pochodzić z jednego z typów wymienionych w poniższej tabeli, aby ObjectDataSource pomyślnie wywołać formant.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.

Typ zwracanyReturn type AkcjaAction
IEnumerable IEnumerableJest zwracany przez Select metodę.The IEnumerable is returned by the Select method.
DataTable A DataView jest tworzony przy użyciu DataTable i zwracany przez Select metodę.A DataView is created by using the DataTable and returned by the Select method.
DataView DataViewJest zwracany przez Select metodę.The DataView is returned by the Select method.
DataSet Pierwszy DataTable z nich DataSet jest wyodrębniany i DataView jest tworzony i zwracany przez Select metodę.The first DataTable of the DataSet is extracted and a DataView is created and returned by the Select method.
Object Obiekt jest opakowany w jednoelementowej IEnumerable kolekcji i zwracany przez Select metodę.The object is wrapped in a one-element IEnumerable collection and returned by the Select method.

Metodą identyfikowaną przez SelectMethod Właściwość może być metoda wystąpienia lub static Shared metoda (w Visual Basic).The method that is identified by the SelectMethod property can be an instance method or a static (Shared in Visual Basic) method. Jeśli jest to metoda wystąpienia, obiekt biznesowy jest tworzony i niszczony za każdym razem, gdy wywoływana jest metoda określona przez SelectMethod Właściwość, z tą różnicą, że to samo wystąpienie jest używane do wywołania metody, która jest określona przez SelectMethod Właściwość i metodę, która jest określona przez SelectCountMethod Właściwość.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. SelectMetoda zwraca IEnumerable interfejs.The Select method returns an IEnumerable interface. Aby jednak włączyć buforowanie i scenariusze filtrowania, zwracana wartość musi być DataSet obiektem.However, to enable caching and filtering scenarios, the return value must be a DataSet object. Chociaż DataSet Klasa nie implementuje IEnumerable interfejsu, ObjectDataSource formant automatycznie wyodrębnia DataView formant domyślny, który implementuje IEnumerable .While the DataSet class does not implement the IEnumerable interface, the ObjectDataSource control automatically extracts the default DataView control, which implements the IEnumerable.

Przed Select wykonaniem operacji OnSelecting Metoda jest wywoływana w celu podniesienia Selecting zdarzenia.Before the Select operation is performed, the OnSelecting method is called to raise the Selecting event. Można obsłużyć Selecting zdarzenie, aby przeanalizować wartości parametrów i wykonać przetwarzanie wstępne przed Select operacją.You can handle the Selecting event to examine the values of the parameters and to perform any preprocessing before a Select operation. Aby wykonać operację pobierania danych, ObjectDataSourceView obiekt używa odbicia w celu utworzenia wystąpienia obiektu, który jest identyfikowany przez TypeName Właściwość.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. Następnie wywołuje metodę, która jest identyfikowana przez SelectMethod Właściwość, przy użyciu wszelkich skojarzonych SelectParameters właściwości.It then calls the method that is identified by the SelectMethod property, using any associated SelectParameters properties. Po Select zakończeniu operacji OnSelected Metoda jest wywoływana w celu podniesienia Selected zdarzenia.After the Select operation completes, the OnSelected method is called to raise the Selected event. Możesz obsłużyć Selected zdarzenie, aby przeanalizować wszelkie zwracane wartości, parametry wyjściowe i wyjątki oraz wykonać dowolne przetwarzanie końcowe.You can handle the Selected event to examine any return values, output parameters, and exceptions, and to perform any post-processing.

Jeśli SelectMethod Właściwość zwraca DataSet DataTable obiekt,, lub DataView jest włączone buforowanie, ObjectDataSource Pobiera dane z i zapisuje dane w pamięci podręcznej podczas Select operacji.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. Pamięć podręczna jest tworzona, odrzucona lub odświeżana na podstawie zachowania pamięci podręcznej, która jest określona przez kombinację CacheDuration CacheExpirationPolicy właściwości i.The cache is created, discarded, or refreshed based on the caching behavior that is specified by the combination of the CacheDuration and CacheExpirationPolicy properties.

Jeśli SelectMethod Właściwość zwraca DataSet DataTable obiekt lub, a właściwość została FilterExpression określona, jest oceniana z wszystkimi dostarczonymi FilterParameters właściwościami, a wynikowy filtr jest stosowany do listy danych podczas Select operacji.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.

SelectMetoda deleguje Select metodę ObjectDataSourceView , która jest skojarzona z ObjectDataSource kontrolką.The Select method delegates to the Select method of the ObjectDataSourceView that is associated with the ObjectDataSource control.

Aby uzyskać więcej informacji na temat scalania parametrów, okresu istnienia obiektu i rozwiązania metody, zobacz SelectMethod .For more information about parameter merging, object lifetime, and method resolution, see SelectMethod.

Formanty powiązane z danymiData-Bound Controls

Gdy ObjectDataSource kontrolka jest skojarzona z kontrolką powiązaną z danymi, taką jak GridView kontrolka, nie trzeba wywoływać Select metody z kodu strony.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. SelectMetoda jest wywoływana bezpośrednio przez formant powiązany z danymi.The Select method is invoked directly by the data-bound control instead.

Dotyczy

Zobacz też