AccessDataSourceView.ExecuteSelect(DataSourceSelectArguments) 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 mithilfe der SQL-Zeichenfolge in der SelectCommand-Eigenschaft und aller Parameter in der SelectParameters-Auflistung ab.

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

Ein DataSourceSelectArguments, das zum Anfordern von Datenvorgängen verwendet wird, die über allgemeine Datenabrufvorgänge hinausgehen.

Gibt zurück

IEnumerable

Eine IEnumerable von Datenzeilen.

Ausnahmen

InvalidOperationException

Die DataFile-Eigenschaft ist null oder enthält eine leere Zeichenfolge ("").

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.

Hinweise

Das AccessDataSourceView -Objekt überschreibt die ExecuteSelect -Methode, um sicherzustellen, dass die DataFile -Eigenschaft des zugeordneten AccessDataSource Steuerelements vor dem Abrufen von Daten festgelegt wird.

Bevor die ExecuteSelect -Methode 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 Datenabrufvorgang vorzuverarbeiten.

Um den Datenabruf durchzuführen, erstellt das AccessDataSourceView -Objekt ein IDbCommand -Objekt unter Verwendung des SelectCommand Texts und aller zugeordneten SelectParameters Eigenschaften. Anschließend führt das AccessDataSourceView -Objekt das -Objekt für den IDbCommand zugrunde liegenden Datenspeicher aus. Nach Abschluss des Vorgangs wird die OnSelected -Methode aufgerufen, um das -Ereignis auszulösen Selected . Sie können das Selected Ereignis behandeln, um alle Rückgabewerte und Fehlercodes zu untersuchen und eine nachbereitende Verarbeitung durchzuführen.

Wenn die DataSourceMode -Eigenschaft auf den DataSet Wert festgelegt ist und die AccessDataSourceView Zwischenspeicherung aktiviert ist, werden während des Datenabrufvorgangs Daten aus dem Cache abgerufen und 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 DataSourceMode Eigenschaft auf den DataSet Wert festgelegt und eine FilterExpression Eigenschaft angegeben wurde, wird die DataSourceMode Eigenschaft zusammen mit allen angegebenen FilterParameters Eigenschaften ausgewertet, und der resultierende Filter wird während des Vorgangs Select auf die Liste der Daten angewendet.

Gilt für: