ObjectDataSource.Select Methode

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

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.IEnumerable

Public Function Select () As IEnumerable

Gibt zurück

IEnumerable

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 Methode, die durch die SelectMethod -Eigenschaft identifiziert wird, kann eine instance-Methode oder eine static (Shared in Visual Basic) -Methode sein. Wenn es sich um eine instance-Methode 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 instance 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. Um einen Datenabrufvorgang auszuführen, verwendet das Objekt reflektionObjectDataSourceView, um eine instance 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.

Gilt für: