SqlDataSourceView.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 der zugrunde liegenden Datenbank mithilfe der SelectCommand SQL-Zeichenfolge und aller Parameter ab, die sich in der SelectParameters Auflistung befinden.
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 Objekt, das verwendet wird, 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 Zwischenspeichern ist aktiviert, aber die DataSourceMode Eigenschaft der Datenquelle ist nicht auf festgelegt DataSet.
-oder-
Die SortParameterName Eigenschaft wird festgelegt, CommandType aber nicht auf StoredProcedure.
Die Datenquelle kann keine Datenbankverbindung erstellen.
-oder-
Die Zwischenspeicherung ist aktiviert, aber die internen Cache- und Befehlstypen stimmen nicht überein.
Hinweise
Die SqlDataSourceView Klasse implementiert die geerbte ExecuteSelect Methode zum Abrufen von Daten aus einer Datenbank. Seitenentwickler und datengebundene Steuerelementautoren rufen die ExecuteSelect Methode nicht direkt auf. Verwenden Sie stattdessen die öffentlich verfügbar gemachte Select Methode.
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 jede Vorverarbeitung durchzuführen, bevor Daten abgerufen werden.
Zum Ausführen des Vorgangs erstellt das SqlDataSourceView Objekt ein DbCommand Objekt mit dem SelectCommand Text und allen zugeordneten SelectParametersObjekten und führt es für die zugrunde liegende Datenbank 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, Fehlercodes zu untersuchen und jede Nachbearbeitung durchzuführen.
Die
Wenn die DataSourceMode Einstellung auf DataSet und Zwischenspeicherung aktiviert ist, werden die SqlDataSourceView Daten aus dem Cache während des Datenvorgangs abgerufen und gespeichert. Der Cache wird basierend auf dem durch die Kombination der CacheDurationCacheExpirationPolicy Eigenschaften angegebenen Zwischenspeicherungsverhalten erstellt, verworfen oder aktualisiert.
Important
Wenn Sie den Identitätswechsel des Clients unter Windows-Authentifizierung verwenden, werden die Daten zwischengespeichert, wenn der erste Benutzer auf die Daten zugreift. Wenn ein anderer Benutzer dieselben Daten anfordert, werden die Daten aus dem Cache abgerufen. Die Daten werden nicht abgerufen, indem sie einen weiteren Aufruf der Datenbank durchführen, um den Zugriff des Benutzers auf die Daten zu überprüfen. Wenn Sie davon ausgehen, dass mehrere Benutzer auf die Daten zugreifen, und sie möchten, dass jeder Abruf der Daten durch die Sicherheitskonfigurationen der Datenbank überprüft wird, verwenden Sie keine Zwischenspeicherung.
Wenn die DataSourceMode Einstellung auf DataSet und eine FilterExpression festgelegt wurde, wird sie zusammen mit allen bereitgestellten FilterParameters Daten ausgewertet, und der resultierende Filter wird während des Datenabrufvorgangs auf die Liste der Daten angewendet.
