ObjectDataSourceView.ExecuteSelect(DataSourceSelectArguments) Methode

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ruft Daten aus einem von der TypeName-Eigenschaft angegebenen Objekt durch Aufruf der von der SelectMethod-Eigenschaft angegebenen Methode ab und übergibt dabei alle Werte in der SelectParameters-Auflistung.

protected public:
 override System::Collections::IEnumerable ^ ExecuteSelect(System::Web::UI::DataSourceSelectArguments ^ arguments);
protected internal override System.Collections.IEnumerable ExecuteSelect (System.Web.UI.DataSourceSelectArguments arguments);
override this.ExecuteSelect : System.Web.UI.DataSourceSelectArguments -> System.Collections.IEnumerable
Protected Friend Overrides Function ExecuteSelect (arguments As DataSourceSelectArguments) As IEnumerable

Parameter

arguments
DataSourceSelectArguments

Eine Instanz von DataSourceSelectArguments, mit der Datenvorgänge angefordert werden, die über grundlegenden Datenabrufvorgänge hinausgehen.

Gibt zurück

IEnumerable

Eine IEnumerable-Liste mit Datenzeilen.

Ausnahmen

NotSupportedException

Die an die ExecuteSelect(DataSourceSelectArguments)-Methode übergebenen arguments geben an, dass die Datenquelle während des Datenabrufs noch weitere Aufgaben ausführen muss, um das Paging oder das Sortieren der abgerufenen Daten zu ermöglichen. Das Datenquellen-Steuerelement unterstützt die erforderlichen Funktionen jedoch nicht.

- oder -

Das von der ExecuteSelect(DataSourceSelectArguments)-Methode zurückgegebene Objekt ist kein DataSet und keine DataTable, und das Zwischenspeichern ist aktiviert. Nur DataSet-Objekte und DataTable-Objekte können für das ObjectDataSourceView-Steuerelement zwischengespeichert werden.

- oder -

Sowohl Zwischenspeicherung als auch Clientidentitätswechsel sind aktiviert. Das ObjectDataSource unterstützt keine Zwischenspeicherung, wenn der Clientidentitätswechsel aktiviert ist.

InvalidOperationException

Das von der ExecuteSelect(DataSourceSelectArguments)-Methode zurückgegebene Objekt ist ein DataSet, in seiner Tables-Auflistung sind jedoch keine Tabellen vorhanden.

- oder -

Die EnablePaging-Eigenschaft ist auf true festgelegt, die StartRowIndexParameterName-Eigenschaft und die MaximumRowsParameterName-Eigenschaft sind jedoch nicht festgelegt.

Hinweise

Die ObjectDataSourceView -Klasse implementiert die geerbte ExecuteSelect Methode zum Abrufen von Daten mithilfe eines Geschäftsobjekts. Seitenentwickler und Autoren von datengebundenen Steuerelementen rufen die ExecuteSelect -Methode nicht direkt auf. Verwenden Sie stattdessen die öffentlich verfügbar gemachte Select Methode.

Die angegebene Methode kann über eine beliebige Methodensignatur verfügen, muss jedoch einen der Typen für das Steuerelement zurückgeben, die ObjectDataSource in der folgenden Tabelle aufgeführt sind, um es erfolgreich aufzurufen.

Rückgabetyp Aktion
IEnumerable Wird IEnumerable von der Select -Methode zurückgegeben.
DataTable Ein DataView wird mit dem DataTable erstellt und 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 ein Ein-Element IEnumerable umschlossen und von der Select -Methode zurückgegeben.

Bevor der Datenabruf ausgeführt wird, wird die OnSelecting -Methode aufgerufen, um das Ereignis auszulösen Selecting . Sie können dieses Ereignis behandeln, um die Werte der Parameter zu untersuchen und vor einem Vorgang vorzuverarbeiten.

Um einen Auswahlvorgang auszuführen, verwendet das Steuerelement reflektion ObjectDataSourceView , um die Methode aufzurufen, die durch die SelectMethod -Eigenschaft und alle zugeordneten Parameter in der SelectParameters Auflistung identifiziert wird, und führt sie dann aus. Nach Abschluss des Vorgangs wird die OnSelected -Methode aufgerufen, um das -Ereignis auszulösen Selected . Sie können dieses Ereignis behandeln, um Alle Rückgabewerte und Fehlercodes zu untersuchen und eine nachbereitende Verarbeitung durchzuführen.

Wenn die Select -Methode ein DataSet -Objekt zurückgibt und die ObjectDataSourceView Zwischenspeicherung aktiviert ist, werden daten aus dem -Objekt abgerufen und während des 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 Select Methode ein DataSet -Objekt zurückgibt und eine FilterExpression Eigenschaft angegeben wurde, wird sie zusammen mit allen angegebenen FilterParameters Eigenschaften ausgewertet, und der resultierende Filter wird während des Vorgangs Select auf die Liste der Daten angewendet.

Informationen zum Zurückgeben der Anzahl der ausgewählten Zeilen finden Sie unter Select.

Gilt für:

Weitere Informationen