Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

SqlDataSourceView.ExecuteSelect-Methode: (DataSourceSelectArguments)

 

Veröffentlicht: Oktober 2016

Ruft Daten aus der zugrunde liegenden Datenbank mithilfe der SelectCommand SQL-Zeichenfolge und allen Parametern, die sich in der SelectParameters Auflistung.

Namespace:   System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

protected internal override IEnumerable ExecuteSelect(
	DataSourceSelectArguments arguments
)

Parameter

arguments
Type: System.Web.UI.DataSourceSelectArguments

Ein DataSourceSelectArguments Objekt verwendet, um Vorgänge für die Daten über einen grundlegenden Datenabruf hinausgehen anzufordern.

Rückgabewert

Type: System.Collections.IEnumerable

Eine IEnumerable Liste von Datenzeilen.

Exception Condition
NotSupportedException

Die arguments übergeben, um die ExecuteSelect Methode angegeben, dass die Datenquelle sollte zusätzliche Arbeit beim Abrufen von Daten zum Aktivieren von paging oder das Sortieren der abgerufenen Daten ausführen, aber das Datenquellen-Steuerelement unterstützt nicht die angeforderte Funktion.

– oder –

Das Zwischenspeichern ist aktiviert, aber die DataSourceMode Eigenschaft der Datenquelle ist nicht auf festgelegt DataSet.

– oder –

Die SortParameterName festgelegt sind, aber CommandType nicht auf festgelegt ist StoredProcedure.

InvalidOperationException

Die Datenquelle kann keine Verbindung mit Datenbank erstellen.

– oder –

Caching ist aktiviert, aber die internen Cache und Befehlstypen stimmen nicht überein.

Die SqlDataSourceView -Klasse implementiert die geerbte ExecuteSelect -Methode zum Abrufen von Daten aus einer Datenbank. Entwickler von Seiten und Autoren von datengebundenen Steuerelementen rufen Sie nicht die ExecuteSelect Methode direkt; stattdessen verwenden, die öffentlich verfügbar gemachten Select Methode.

Vor dem Abrufen von Daten ausgeführt wird, die OnSelecting Methode wird aufgerufen, um das Auslösen der Selecting Ereignis. Sie können dieses Ereignis, um die Werte der Parameter überprüfen und Ausführen jeder vorverarbeiten, bevor Daten abgerufen werden, behandeln.

Zum Ausführen des Vorgangs die SqlDataSourceView -Objekt Builds ein DbCommand -Objekt unter Verwendung der SelectCommand Text und alle zugehörigen SelectParameters, und führt es dann für die zugrunde liegende Datenbank. Nach Abschluss des Vorgangs die OnSelected Methode wird aufgerufen, um das Auslösen der Selected Ereignis. Sie können dieses Ereignis untersuchen Sie alle Rückgabewerte Fehlercodes, und führen Nachbearbeitung.

Die ExecuteSelect -Methode gibt ein DataView Objekt, wenn die DataSourceMode auf festgelegt ist DataSet, oder ein IDataReader Objekt, wenn die DataSourceMode auf festgelegt ist DataReader. Schließen der IDataReader Objekt, wenn Sie die Daten gelesen haben.

Wenn die DataSourceMode auf festgelegt ist DataSet und das Zwischenspeichern aktiviert ist, wird die SqlDataSourceView Daten abruft und speichert Daten im Cache während des Datenvorgangs. Der Cache wird erstellt, verworfen oder aktualisiert auf Grundlage der Zwischenspeicherungsverhaltens angegeben durch die Kombination der CacheDuration und CacheExpirationPolicy Eigenschaften.

System_CAPS_security Sicherheit Hinweis

Wenn Sie Identitätswechsel des Clients unter Windows-Authentifizierung verwenden, werden die Daten zwischengespeichert, wenn der erste Benutzer auf die Daten zugreift. Wenn ein anderer Benutzer die gleichen Daten anfordert, werden die Daten aus dem Cache abgerufen. Die Daten werden durch einen weiteren Aufruf an die Datenbank, überprüfen Sie, ob der Benutzer Zugriff auf die Daten abgerufen. Wenn Sie erwarten, dass mehrere Benutzer Zugriff auf die Daten, und jeder Abruf der Daten von der Datenbank-Sicherheitskonfigurationen überprüft werden soll, verwenden Sie kein Zwischenspeichern.

Wenn die DataSourceMode festgelegt ist, um DataSet und FilterExpression angegeben wurde, wird er zusammen mit allen bereitgestellten ausgewertet FilterParameters und der resultierende Filter auf die Liste der Daten während der Datenabrufvorgang angewendet.

.NET Framework
Verfügbar seit 2.0
Zurück zum Anfang
Anzeigen: