ObjectDataSourceView.ExecuteSelect(DataSourceSelectArguments) 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 Objekt ab, das von der TypeName Eigenschaft identifiziert wird, indem die von der SelectMethod Eigenschaft identifizierte Methode aufgerufen und alle Werte in der SelectParameters Auflistung übergeben werden.
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.IEnumerableProtected Friend Overrides Function ExecuteSelect (arguments As DataSourceSelectArguments) As IEnumerableParameter
- arguments
- DataSourceSelectArguments
Ein DataSourceSelectArguments Verwendeter, um Vorgänge für die Daten anzufordern, die über das grundlegende Abrufen von Daten hinausgehen.
Gibt zurück
Eine IEnumerable Liste von Datenzeilen.
Ausnahmen
Die arguments an die ExecuteSelect(DataSourceSelectArguments) Methode übergebene Methode gibt an, dass die Datenquelle beim Abrufen von Daten zusätzliche Arbeit ausführen soll, um das Ausblättern oder Sortieren der abgerufenen Daten zu ermöglichen, das Datenquellensteuerelement unterstützt jedoch nicht die angeforderte Funktion.
- oder -
Das von der ExecuteSelect(DataSourceSelectArguments) Methode zurückgegebene Objekt ist kein DataSet oder DataTable, und die Zwischenspeicherung ist aktiviert. Nur DataSet und DataTable Objekte können für das ObjectDataSourceView Steuerelement zwischengespeichert werden.
- oder -
Sowohl zwischenspeichern als auch Clientidentitätswechsel sind aktiviert. Die ObjectDataSource Zwischenspeicherung wird nicht unterstützt, wenn der Clientidentitätswechsel aktiviert ist.
Das von der ExecuteSelect(DataSourceSelectArguments) Methode zurückgegebene Objekt ist ein DataSet, enthält jedoch keine Tabellen in der Tables Auflistung.
- oder -
Die EnablePaging Eigenschaft ist auf truefestgelegt, aber die StartRowIndexParameterName Eigenschaften werden MaximumRowsParameterName nicht festgelegt.
Hinweise
Die ObjectDataSourceView Klasse implementiert die geerbte ExecuteSelect Methode zum Abrufen von Daten mithilfe eines Geschäftsobjekts. Seitenentwickler und datengebundene Steuerelementautoren rufen die ExecuteSelect Methode nicht direkt auf. Verwenden Sie stattdessen die öffentlich verfügbar gemachte Select Methode.
Die angegebene Methode kann eine beliebige Methodensignatur aufweisen, muss jedoch einen der Typen für das ObjectDataSource Steuerelement zurückgeben, das in der folgenden Tabelle aufgeführt ist, um es erfolgreich aufzurufen.
| 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. |
| DataSet | Der erste DataTable der DataSet extrahierten Und eine DataView wird von der Select Methode erstellt und zurückgegeben. |
| Object | Das Objekt wird in ein 1-Element IEnumerable eingeschlossen und von der Select Methode zurückgegeben. |
Bevor der Datenabruf ausgeführt wird, wird die OnSelecting Methode aufgerufen, um das Selecting Ereignis auszuheben. Sie können dieses Ereignis behandeln, um die Werte der Parameter zu untersuchen und alle Vorverarbeitungen vor einem Vorgang auszuführen.
Zum Ausführen eines Auswahlvorgangs verwendet das ObjectDataSourceView Steuerelement Spiegelung, um die Methode aufzurufen, die durch die SelectMethod Eigenschaft und alle zugehörigen Parameter in der SelectParameters Auflistung identifiziert wird, und führt sie dann aus. Nach Abschluss des Vorgangs wird die OnSelected Methode aufgerufen, um das Selected Ereignis auszuheben. Sie können dieses Ereignis behandeln, um alle Rückgabewerte und Fehlercodes zu untersuchen und jede Nachbearbeitung durchzuführen.
Wenn die Select Methode ein DataSet Objekt zurückgibt und zwischenspeichern aktiviert ist, werden die ObjectDataSourceView Daten aus dem Cache während des 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 Select Methode ein DataSet Objekt zurückgibt und eine FilterExpression Eigenschaft angegeben wurde, wird sie zusammen mit allen bereitgestellten FilterParameters Eigenschaften ausgewertet, und der resultierende Filter wird während des Select Vorgangs auf die Liste der Daten angewendet.
Informationen zum Zurückgeben der Anzahl der ausgewählten Zeilen finden Sie unter Select.
