AccessDataSourceView.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 zugrunde liegenden Datenspeicher mithilfe der SQL-Zeichenfolge in der SelectCommand Eigenschaft und allen Parametern 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
Eine DataSourceSelectArguments , die verwendet wird, um Vorgänge für die Daten anzufordern, die über den grundlegenden Datenempfang hinausgehen.
Gibt zurück
Eine IEnumerable Von Datenzeilen.
Ausnahmen
Die DataFile Eigenschaft ist null oder eine leere Zeichenfolge ("").
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.
Hinweise
Das AccessDataSourceView Objekt setzt die ExecuteSelect Methode außer Kraft, um sicherzustellen, dass die DataFile Eigenschaft des zugeordneten AccessDataSource Steuerelements festgelegt wird, bevor Daten abgerufen werden.
Bevor die ExecuteSelect Methode ausgeführt wird, wird die OnSelecting Methode aufgerufen, um das Selecting Ereignis auszuheben. Sie können das Selecting Ereignis behandeln, um die Werte der Parameter zu untersuchen und alle Vorverarbeitungen vor einem Datenabrufvorgang durchzuführen.
Um den Datenabruf durchzuführen, erstellt das AccessDataSourceView Objekt ein IDbCommand Objekt mit dem SelectCommand Text und den zugehörigen SelectParameters Eigenschaften. Anschließend führt das AccessDataSourceView Objekt das IDbCommand Objekt für den zugrunde liegenden Datenspeicher aus. Nach Abschluss des Vorgangs wird die OnSelected Methode aufgerufen, um das Selected Ereignis auszuheben. Sie können das Selected Ereignis behandeln, um alle Rückgabewerte und Fehlercodes zu untersuchen und jede Nachbearbeitung durchzuführen.
Wenn die DataSourceMode Eigenschaft auf den DataSet Wert und die Zwischenspeicherung festgelegt ist, werden die AccessDataSourceView Daten aus dem Cache während des Datenempfangsvorgangs abgerufen und im Cache gespeichert. Der Cache wird erstellt, verworfen oder aktualisiert, basierend auf dem Zwischenspeicherungsverhalten, das durch die Kombination der Eigenschaften und CacheExpirationPolicy die CacheDuration Kombination angegeben wird.
Wenn die DataSourceMode Eigenschaft auf den DataSet Wert festgelegt ist und eine FilterExpression Eigenschaft angegeben wurde, wird die DataSourceMode Eigenschaft zusammen mit allen bereitgestellten FilterParameters Eigenschaften ausgewertet, und der resultierende Filter wird während des Select Vorgangs auf die Liste der Daten angewendet.