ObjectDataSource.Select Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft Daten aus dem zugrunde liegenden Datenspeicher ab, indem die Methode aufgerufen wird, die von der SelectMethod Eigenschaft mit den Parametern in der SelectParameters Auflistung identifiziert wird.
public:
System::Collections::IEnumerable ^ Select();public System.Collections.IEnumerable Select();member this.Select : unit -> System.Collections.IEnumerablePublic Function Select () As IEnumerableGibt zurück
Eine IEnumerable Liste von Datenzeilen.
Beispiele
Ein Codebeispiel finden Sie unter ObjectDataSource.
Hinweise
Die angegebene Methode verfügt möglicherweise über eine Methodensignatur, muss jedoch von einem der in der folgenden Tabelle aufgeführten Typen zurückgegeben oder abgeleitet werden, damit das ObjectDataSource Steuerelement es erfolgreich aufrufen kann.
| Rückgabetyp | Action |
|---|---|
| IEnumerable | Dies IEnumerable wird von der Select Methode zurückgegeben. |
| DataTable | A DataView wird mithilfe der DataTable Methode erstellt und von dieser Select zurückgegeben. |
| DataView | Dies DataView wird von der Select Methode zurückgegeben. |
| DataSet | Der erste DataTable der DataSet extrahierten Und eine DataView wird von der Select Methode erstellt und zurückgegeben. |
| Object | Das Objekt wird in eine 1-Element-Auflistung IEnumerable umbrochen und von der Select Methode zurückgegeben. |
Die von der SelectMethod Eigenschaft identifizierte Methode kann eine Instanzmethode oder eine static (Shared in Visual Basic)-Methode sein. Wenn es sich um eine Instanzmethode handelt, wird das Geschäftsobjekt jedes Mal erstellt und zerstört, wenn die von der SelectMethod Eigenschaft angegebene Methode aufgerufen wird, mit der Ausnahme, dass dieselbe Instanz verwendet wird, um die von der SelectMethod Eigenschaft angegebene Methode und die von der SelectCountMethod Eigenschaft angegebene Methode aufzurufen. Die Select Methode gibt eine IEnumerable Schnittstelle zurück. Zum Aktivieren von Zwischenspeicherungs- und Filterszenarien muss der Rückgabewert jedoch ein DataSet Objekt sein. Obwohl die Klasse die DataSetIEnumerable Schnittstelle nicht implementiert, extrahiert das ObjectDataSource Steuerelement automatisch das Standardsteuerelement DataView , das die IEnumerable.
Bevor der Select Vorgang ausgeführt wird, wird die OnSelecting Methode aufgerufen, um das Selecting Ereignis auszuheben. Sie können das Selecting Ereignis behandeln, um die Werte der Parameter zu untersuchen und alle Vorverarbeitungen vor einem Select Vorgang auszuführen. Zum Ausführen eines Datenabrufvorgangs verwendet das ObjectDataSourceView Objekt Spiegelung, um eine Instanz des Objekts zu erstellen, das durch die TypeName Eigenschaft identifiziert wird. Anschließend wird die Methode aufgerufen, die von der SelectMethod Eigenschaft identifiziert wird, wobei alle zugeordneten Eigenschaften verwendet werden SelectParameters . Nach Abschluss des Select Vorgangs wird die OnSelected Methode aufgerufen, um das Selected Ereignis auszuheben. Sie können das Selected Ereignis behandeln, um alle Rückgabewerte, Ausgabeparameter und Ausnahmen zu untersuchen und jede Nachbearbeitung durchzuführen.
Wenn die SelectMethod Eigenschaft ein DataSet, DataTableoder DataView objekt und Zwischenspeicherung aktiviert ist, werden die ObjectDataSource Daten aus dem Cache während des Select Vorgangs abgerufen und gespeichert. Der Cache wird basierend auf dem Zwischenspeicherungsverhalten erstellt, verworfen oder aktualisiert, das durch die Kombination der Eigenschaften und CacheExpirationPolicy die CacheDuration Kombination angegeben wird.
Wenn die SelectMethod Eigenschaft ein oder DataTable ein DataSet Objekt zurückgibt und eine FilterExpression Eigenschaft angegeben wurde, wird sie mit allen bereitgestellten FilterParameters Eigenschaften ausgewertet, und der resultierende Filter wird während des Select Vorgangs auf die Liste der Daten angewendet.
Die Select Methode delegiert an die Select Methode des Steuerelements, das ObjectDataSourceView dem ObjectDataSource Steuerelement zugeordnet ist.
Weitere Informationen zum Zusammenführen von Parametern, zur Objektlebensdauer und zur Methodenauflösung finden Sie unter SelectMethod.
Data-Bound-Steuerelemente
Wenn das ObjectDataSource Steuerelement einem datengebundenen Steuerelement zugeordnet ist, z. B. dem GridView Steuerelement, ist es nicht erforderlich, die Select Methode aus Seitencode aufzurufen. Die Select Methode wird stattdessen direkt vom datengebundenen Steuerelement aufgerufen.
