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 von der SelectMethod-Eigenschaft angegebene Methode mit den Parametern in der SelectParameters-Auflistung aufgerufen 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 mit Datenzeilen.
Beispiele
Ein Codebeispiel finden Sie unter ObjectDataSource.
Hinweise
Die angegebene Methode kann über eine beliebige Methodensignatur verfügen, sie muss jedoch einen der in der folgenden Tabelle aufgeführten Typen zurückgeben oder daraus abgeleitet werden, damit das ObjectDataSource Steuerelement sie erfolgreich aufrufen kann.
| Rückgabetyp | Aktion |
|---|---|
| IEnumerable | Wird IEnumerable von der Select -Methode zurückgegeben. |
| DataTable | Ein DataView wird mithilfe von DataTable erstellt und von der Select -Methode zurückgegeben. |
| DataView | Wird DataView von der Select -Methode zurückgegeben. |
| DataSet | Die erste DataTable der DataSet wird extrahiert, und ein DataView wird erstellt und von der Select -Methode zurückgegeben. |
| Object | Das Objekt wird in eine Ein-Element-Auflistung IEnumerable umschlossen und von der Select -Methode zurückgegeben. |
Die durch die 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 methode aufzurufen, die von der SelectMethod -Eigenschaft angegeben wird, und die Methode, die von der SelectCountMethod -Eigenschaft angegeben wird. Die Select -Methode gibt eine IEnumerable Schnittstelle zurück. Zum Aktivieren von Zwischenspeicherungs- und Filterszenarien muss der Rückgabewert jedoch ein DataSet -Objekt sein. Während die DataSet -Klasse die IEnumerable -Schnittstelle nicht implementiert, extrahiert das ObjectDataSource Steuerelement automatisch das Standardsteuerelement DataView , das implementiert IEnumerable.
Bevor der Select Vorgang ausgeführt wird, wird die OnSelecting -Methode aufgerufen, um das Ereignis auszulösen Selecting . Sie können das Selecting Ereignis behandeln, um die Werte der Parameter zu untersuchen und vor einem Select Vorgang vorzuverarbeiten. Zum Ausführen eines Datenabrufvorgangs verwendet das -Objekt reflektion ObjectDataSourceView , um eine Instanz des Objekts zu erstellen, das durch die TypeName -Eigenschaft identifiziert wird. Anschließend wird die Methode aufgerufen, die durch die SelectMethod -Eigenschaft identifiziert wird, und verwendet dabei alle zugeordneten SelectParameters Eigenschaften. Nach Abschluss des Select Vorgangs wird die OnSelected -Methode aufgerufen, um das -Ereignis auszulösen Selected . Sie können das Selected Ereignis behandeln, um Rückgabewerte, Ausgabeparameter und Ausnahmen zu untersuchen und eine nachbereitende Verarbeitung durchzuführen.
Wenn die SelectMethod -Eigenschaft ein DataSet- , DataTable- oder DataView -Objekt zurückgibt, und die ObjectDataSource Zwischenspeicherung aktiviert ist, werden daten aus abgerufen und während des Select Vorgangs im Cache gespeichert. Der Cache wird basierend auf dem Zwischenspeicherungsverhalten erstellt, verworfen oder aktualisiert, das durch die Kombination der CacheDuration Eigenschaften und CacheExpirationPolicy angegeben wird.
Wenn die SelectMethod Eigenschaft ein - oder DataTable -DataSetObjekt zurückgibt und eine FilterExpression Eigenschaft angegeben wurde, wird sie mit allen angegebenen FilterParameters Eigenschaften ausgewertet, und der resultierende Filter wird während des Vorgangs Select auf die Liste der Daten angewendet.
Die Select -Methode delegiert an die Select -Methode der , die ObjectDataSourceView dem ObjectDataSource -Steuerelement zugeordnet ist.
Weitere Informationen zum Zusammenführen von Parametern, zur Objektlebensdauer und zur Methodenauflösung finden Sie unter SelectMethod.
Datengebundene Steuerelemente
Wenn das ObjectDataSource Steuerelement einem datengebundenen Steuerelement zugeordnet ist, z. B. dem GridView -Steuerelement, ist es nicht erforderlich, die Select -Methode aus dem Seitencode aufzurufen. Die Select -Methode wird stattdessen direkt vom datengebundenen Steuerelement aufgerufen.
