SqlDataSourceView Klasse

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.

Unterstützt das SqlDataSource-Steuerelement und stellt eine Schnittstelle für datengebundene Steuerelemente zum Ausführen von SQL-Datenvorgängen in relationalen Datenbanken bereit.

public ref class SqlDataSourceView : System::Web::UI::DataSourceView, System::Web::UI::IStateManager

public class SqlDataSourceView : System.Web.UI.DataSourceView, System.Web.UI.IStateManager

type SqlDataSourceView = class
    inherit DataSourceView
    interface IStateManager

Public Class SqlDataSourceView
Inherits DataSourceView
Implements IStateManager

Vererbung: Object

DataSourceView
SqlDataSourceView

Abgeleitet: System.Web.UI.WebControls.AccessDataSourceView

Implementiert: IStateManager

Hinweise

Die SqlDataSourceView -Klasse soll in erster Linie von datengebundenen Steuerelementen und nicht als programmierbares Objekt im Seitencode verwendet werden.

ASP.NET Datenquellensteuerelemente eine oder mehrere Listen von Daten enthalten, die durch Datenquellensichtobjekte dargestellt werden. Die SqlDataSourceView -Klasse erweitert die DataSourceView -Klasse, definiert die Funktionen des SqlDataSource Steuerelements, dem sie zugeordnet ist, und implementiert die grundlegende Datenfunktionalität für das Datenquellensteuerelement. Die SqlDataSourceView -Klasse implementiert die Datenfunktionalität für das SqlDataSource Steuerelement, einschließlich der SelectVorgänge , Update, Insertund Delete , des Sortierens, Filterns und Verwaltens von Einstellungen, die sich im Ansichtszustand befinden.

Obwohl das SqlDataSourceView -Objekt vom Steuerelement nicht direkt für Seitenentwickler SqlDataSource verfügbar gemacht wird, sind es viele seiner Eigenschaften. Der einfachste Vorgang, den eine Datenquellensicht ausführt, ist der Datenabruf aus der zugrunde liegenden Datenbank mithilfe der Select -Methode, die eine IEnumerable Sammlung von Datenelementen abruft. Die SqlDataSourceView -Klasse implementiert den Datenabruf aus relationalen Datenbanken mithilfe von SQL-Abfragen. Die SQL-Abfragen können parametrisiert werden, um mehr Flexibilität und Sicherheit zu erzielen. Die folgenden Methoden, Eigenschaften und Ereignisse zum Abrufen von Daten werden von der SqlDataSourceView implementiert und direkt vom zugehörigen SqlDataSource Steuerelement für Seitenentwickler und andere Aufrufer verfügbar gemacht:

Die SelectCommand-Eigenschaft.
Die SelectParameters-Eigenschaft.
Das Selecting-Ereignis
Das Selected-Ereignis

Das SqlDataSourceView -Objekt unterstützt das Aktualisieren von Daten in einer relationalen Datenbank mithilfe von SQL-Befehlen. Die SQL-Befehle können parametrisiert werden, um mehr Flexibilität und Sicherheit zu erzielen. Datengebundene Steuerelemente wie GridView und DetailsViewkönnen so konfiguriert werden, dass Updates automatisch mithilfe von SqlDataSourceViewausgeführt werden, während dies bei anderen Steuerelementen nicht möglich ist. Die folgenden Updatemethoden, Eigenschaften und Ereignisse werden von SqlDataSourceView implementiert und direkt von seinem SqlDataSource Steuerelement für Seitenentwickler und andere Aufrufer verfügbar gemacht:

Die UpdateCommand-Eigenschaft.
Die UpdateParameters-Eigenschaft.
Das Updating-Ereignis
Das Updated-Ereignis

Unterstützt SqlDataSourceView das Einfügen neuer Datenzeilen in eine relationale Datenbank. Die sql-Befehle, die in der InsertCommand -Eigenschaft angegeben sind, können für mehr Flexibilität und Sicherheit parametrisiert werden. Datengebundene Steuerelemente, z GridView . B. und DetailsView, können so konfiguriert werden, dass Einfügungen automatisch mithilfe von SqlDataSourceViewausgeführt werden, während andere Steuerelemente dies nicht können. Die folgenden Einfügemethoden, Eigenschaften und Ereignisse werden von SqlDataSourceView implementiert und direkt von seinem SqlDataSource Steuerelement für Seitenentwickler und andere Aufrufer verfügbar gemacht:

Die InsertCommand-Eigenschaft.
Die InsertParameters-Eigenschaft.
Das Inserting-Ereignis
Das Inserted-Ereignis

Das SqlDataSourceView -Objekt unterstützt auch das Löschen von Daten aus einer relationalen Datenbank. Wie bei anderen Befehlen können die sql-Befehle, die in der DeleteCommand -Eigenschaft angegeben sind, parametrisiert werden, um mehr Flexibilität und Sicherheit zu erzielen. Datengebundene Steuerelemente, z GridView . B. und DetailsView, können so konfiguriert werden, dass Löschvorgänge automatisch mithilfe von SqlDataSourceViewausgeführt werden, während dies bei anderen Steuerelementen nicht möglich ist. Die folgenden Löschmethoden, Eigenschaften und Ereignisse werden von SqlDataSourceView implementiert und direkt von seinem SqlDataSource Steuerelement für Seitenentwickler und andere Aufrufer verfügbar gemacht:

Die DeleteCommand-Eigenschaft.
Die DeleteParameters-Eigenschaft.
Das Deleting-Ereignis
Das Deleted-Ereignis

Der Datenabruf ist leistungsfähiger, wenn die -Klausel, die zum Filtern der Daten während des Datenabrufs verwendet wird, dynamisch ist. Anders ausgedrückt: Eine SQL-Abfrage mit einer statischen WHERE-Klausel ist nicht so flexibel und leistungsfähig wie eine SQL-Abfrage, bei der die Werte in der WHERE-Klausel an Werte gebunden sind, die sich ändern können, z. B. Werte, die in Steuerelementen auf einer Web Forms-Seite angezeigt werden. Anstatt eine SQL-Abfrage neu zu erstellen und die SelectCommand Eigenschaft bei jedem Seitenladevorgang festzulegen, können Sie die FilterExpression Eigenschaften und FilterParameters verwenden, um dynamische Filterung auf den Datenabruf anzuwenden. Diese Eigenschaften werden von SqlDataSourceView implementiert und direkt von seinem SqlDataSource Steuerelement für datengebundene Steuerelemente und andere Aufrufer verfügbar gemacht.

Sie können die Daten, die Sie mit dem SqlDataSource Steuerelement abrufen, sortieren, indem Sie eine ORDER BY-Klausel hinzufügen, wodurch die Datenbank die Reihenfolge für Sie ausführt, wenn Sie Daten abrufen, oder indem Sie die Daten nach dem Abrufen im Arbeitsspeicher sortieren. Sie können einen Sortierausdruck für angeben, SqlDataSourceView indem Sie die SortExpression -Eigenschaft des DataSourceSelectArguments Objekts festlegen, das an die Select -Methode übergeben wird. Die Syntax für die SortExpression Eigenschaft ist identisch mit der Syntax für eine DataView.Sort Eigenschaft. Wenn Sie eine gespeicherte Prozedur zum Abrufen von Daten verwenden, können Sie auch die SortParameterName -Eigenschaft verwenden, um einen Parameter anzugeben, der speziell zum Sortieren der Ergebnisse eines Aufrufs einer gespeicherten Prozedur verwendet wird.

Wenn mehrere Benutzer die Datenbank gleichzeitig ändern können, besteht die Möglichkeit eines Parallelitätskonflikts. Das SqlDataSource Steuerelement verfügt über die Parallelität von Steuerelementen über die SqlDataSource.ConflictDetection -Eigenschaft. Die Funktionalität wird in der SqlDataSourceView.ConflictDetection -Eigenschaft implementiert.

Wie viele andere Webserversteuerelemente implementiert die SqlDataSourceView -Schnittstelle und verwendet den IStateManager Ansichtszustand, um den Zustand über Seitenanforderungen hinweg nachzuverfolgen. Implementierungen der - und - IsTrackingViewState Eigenschaft und der LoadViewStateMethoden , SaveViewStateund TrackViewState werden bereitgestellt, um die Ansichtsstatusnachverfolgung für das Steuerelement zu ermöglichen. Weitere Informationen finden Sie unter Übersicht über ASP.NET Zustandsverwaltung.

Konstruktoren

SqlDataSourceView(SqlDataSource, String, HttpContext)

Initialisiert eine neue Instanz der SqlDataSourceView-Klasse, die das angegebene SqlDataSource-Steuerelement als Besitzer der aktuellen Ansicht festlegt.

Eigenschaften

CancelSelectOnNullParameter	Ruft einen Wert ab, der angibt, ob ein Datenabrufvorgang abgebrochen werden soll, wenn einer der in der SelectParameters-Auflistung enthaltenen Parameter mit `null` ausgewertet wird, oder legt diesen Wert fest.
CanDelete	Ruft einen Wert ab, der angibt, ob das SqlDataSourceView-Objekt, das dem aktuellen SqlDataSource-Steuerelement zugeordnet ist, den Löschvorgang unterstützt.
CanInsert	Ruft einen Wert ab, der angibt, ob das SqlDataSourceView-Objekt, das dem aktuellen SqlDataSource-Steuerelement zugeordnet ist, den Einfügevorgang unterstützt.
CanPage	Ruft einen Wert ab, der angibt, ob das Paging der abgerufenen Daten vom SqlDataSourceView-Objekt unterstützt wird, das dem aktuellen SqlDataSource-Objekt zugeordnet ist.
CanRetrieveTotalRowCount	Ruft einen Wert ab, der angibt, ob das SqlDataSourceView-Objekt, das dem aktuellen SqlDataSource-Steuerelement zugeordnet ist, das Abrufen der Gesamtanzahl der Datenzeilen (zusätzlich zum Datensatz) unterstützt.
CanSort	Ruft einen Wert ab, der angibt, ob das SqlDataSourceView-Objekt, das dem aktuellen SqlDataSource-Steuerelement zugeordnet ist, eine sortierte Ansicht der abgerufenen Daten unterstützt.
CanUpdate	Ruft einen Wert ab, der angibt, ob das SqlDataSourceView-Objekt, das dem aktuellen SqlDataSource-Steuerelement zugeordnet ist, den Aktualisierungsvorgang unterstützt.
ConflictDetection	Ruft einen Wert ab, der bestimmt, wie das SqlDataSource-Steuerelement Aktualisierungs- und Löschvorgänge ausführt, wenn die Daten einer Zeile in der zugrunde liegenden Datenbank während der Vorgangsausführung geändert werden, oder legt diesen Wert fest.
DeleteCommand	Ruft die SQL-Zeichenfolge ab, die von SqlDataSourceView zum Löschen von Daten aus der zugrunde liegenden Datenbank verwendet wird, oder legt diese fest.
DeleteCommandType	Ruft einen Wert ab, der angibt, ob der Text in der DeleteCommand-Eigenschaft eine SQL-Anweisung oder der Name einer gespeicherten Prozedur ist, oder legt diesen Wert fest.
DeleteParameters	Ruft die Parameterauflistung ab, die die von der DeleteCommand-Eigenschaft verwendeten Parameter enthält.
Events	Ruft eine Liste von Ereignishandlerdelegaten für die Datenquellenansicht ab. (Geerbt von DataSourceView)
FilterExpression	Ruft einen Filterausdruck ab, der angewendet wird, wenn die Select-Methode aufgerufen wird, oder legt diesen fest.
FilterParameters	Ruft eine Auflistung von Parametern ab, die beliebigen Parameterplatzhaltern in der FilterExpression-Zeichenfolge zugeordnet sind.
InsertCommand	Ruft die SQL-Zeichenfolge ab, mit deren Hilfe das SqlDataSourceView-Objekt Daten in die zugrunde liegende Datenbank einfügt, oder legt diese fest.
InsertCommandType	Ruft einen Wert ab, der angibt, ob der Text in der InsertCommand-Eigenschaft eine SQL-Anweisung oder der Name einer gespeicherten Prozedur ist, oder legt diesen Wert fest.
InsertParameters	Ruft die Parameterauflistung ab, die die von der InsertCommand-Eigenschaft verwendeten Parameter enthält.
IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das SqlDataSourceView-Objekt Änderungen des Ansichtszustands speichert.
Name	Ruft den Namen der Datenquellenansicht ab. (Geerbt von DataSourceView)
OldValuesParameterFormatString	Ruft eine Formatzeichenfolge ab, die auf die Namen aller Parameter angewendet wird, die an die Delete-Methode oder an die Update-Methode übergeben werden, oder legt diese Formatzeichenfolge fest.
ParameterPrefix	Ruft die Zeichenfolge ab, die als Präfix für einen Parameterplatzhalter in einer parametrisierten SQL-Abfrage fungiert.
SelectCommand	Ruft die SQL-Zeichenfolge ab, die vom SqlDataSourceView-Objekt zum Abrufen von Daten aus der zugrunde liegenden Datenbank verwendet wird, oder legt diese Zeichenfolge fest.
SelectCommandType	Ruft einen Wert ab, der angibt, ob der Text in der SelectCommand-Eigenschaft eine SQL-Abfrage oder der Name einer gespeicherten Prozedur ist, oder legt diesen Wert fest.
SelectParameters	Ruft die Parameterauflistung ab, die die von der SelectCommand-Eigenschaft verwendeten Parameter enthält.
SortParameterName	Ruft den Namen eines Parameters für eine gespeicherte Prozedur ab, mit der abgerufene Daten sortiert werden, sofern der Abruf mit einer gespeicherten Prozedur erfolgt ist, oder legt diesen Namen fest.
UpdateCommand	Ruft die SQL-Zeichenfolge ab, die vom SqlDataSourceView-Objekt zum Aktualisieren von Daten in der zugrunde liegenden Datenbank verwendet wird, oder legt diese Zeichenfolge fest.
UpdateCommandType	Ruft einen Wert ab, der angibt, ob der Text in der UpdateCommand-Eigenschaft eine SQL-Anweisung oder der Name einer gespeicherten Prozedur ist, oder legt diesen Wert fest.
UpdateParameters	Ruft die Parameterauflistung ab, die die von der UpdateCommand-Eigenschaft verwendeten Parameter enthält.

Methoden

CanExecute(String)	Bestimmt, ob der angegebene Befehl ausgeführt werden kann. (Geerbt von DataSourceView)
Delete(IDictionary, IDictionary)	Führt mit der DeleteCommand-SQL-Zeichenfolge, allen in der DeleteParameters-Auflistung angegebenen Parametern sowie den Werten in der angegebenen `keys`-Auflistung und der angegebenen `oldValues`-Auflistung einen Löschvorgang aus.
Delete(IDictionary, IDictionary, DataSourceViewOperationCallback)	Führt einen asynchronen Löschvorgang in der Liste der Daten aus, die das DataSourceView-Objekt darstellt. (Geerbt von DataSourceView)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
ExecuteCommand(String, IDictionary, IDictionary)	Führt den angegebenen Befehl aus. (Geerbt von DataSourceView)
ExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)	Führt den angegebenen Befehl aus. (Geerbt von DataSourceView)
ExecuteDelete(IDictionary, IDictionary)	Führt mit der DeleteCommand-SQL-Zeichenfolge, allen in der DeleteParameters-Auflistung angegebenen Parametern sowie den Werten in der angegebenen `keys`-Auflistung und der angegebenen `oldValues`-Auflistung einen Löschvorgang aus.
ExecuteInsert(IDictionary)	Führt mithilfe der InsertCommand-SQL-Zeichenfolge, aller in der InsertParameters-Auflistung angegebenen Parameter sowie der Werte in der angegebenen `values`-Auflistung einen Einfügevorgang aus.
ExecuteSelect(DataSourceSelectArguments)	Ruft Daten aus der zugrunde liegenden Datenbank mithilfe der SelectCommand-SQL-Zeichenfolge und aller Parameter in der SelectParameters-Auflistung ab.
ExecuteUpdate(IDictionary, IDictionary, IDictionary)	Führt mithilfe der UpdateCommand-SQL-Zeichenfolge, aller Parameter in der UpdateParameters-Auflistung sowie der Werte in den angegebenen Auflistungen `keys`, `values` und `oldValues` einen Aktualisierungsvorgang aus.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
Insert(IDictionary)	Führt mithilfe der InsertCommand-SQL-Zeichenfolge, aller in der InsertParameters-Auflistung angegebenen Parameter sowie der Werte in der angegebenen `values`-Auflistung einen Einfügevorgang aus.
Insert(IDictionary, DataSourceViewOperationCallback)	Führt einen asynchronen Einfügevorgang in der Liste der Daten aus, die das DataSourceView-Objekt darstellt. (Geerbt von DataSourceView)
LoadViewState(Object)	Stellt den vorher gespeicherten Ansichtszustand für die Datenquellenansicht wieder her.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnDataSourceViewChanged(EventArgs)	Löst das DataSourceViewChanged-Ereignis aus. (Geerbt von DataSourceView)
OnDeleted(SqlDataSourceStatusEventArgs)	Löst das Deleted-Ereignis aus, nachdem das SqlDataSource-Steuerelement einen Löschvorgang abgeschlossen hat.
OnDeleting(SqlDataSourceCommandEventArgs)	Löst das Deleting-Ereignis aus, bevor das SqlDataSource-Steuerelement einen Löschvorgang startet.
OnFiltering(SqlDataSourceFilteringEventArgs)	Löst das Filtering-Ereignis aus, bevor das SqlDataSource-Steuerelement die Ergebnisse eines Auswahlvorgangs filtert.
OnInserted(SqlDataSourceStatusEventArgs)	Löst das Inserted-Ereignis aus, nachdem das SqlDataSource-Steuerelement einen Einfügevorgang abgeschlossen hat.
OnInserting(SqlDataSourceCommandEventArgs)	Löst das Inserting-Ereignis aus, bevor das SqlDataSource-Steuerelement einen Einfügevorgang startet.
OnSelected(SqlDataSourceStatusEventArgs)	Löst das Selected-Ereignis aus, nachdem das SqlDataSource-Steuerelement einen Datenabrufvorgang abgeschlossen hat.
OnSelecting(SqlDataSourceSelectingEventArgs)	Löst das Selecting-Ereignis aus, bevor das SqlDataSource-Steuerelement einen Datenabrufvorgang startet.
OnUpdated(SqlDataSourceStatusEventArgs)	Löst das Updated-Ereignis aus, nachdem das SqlDataSource-Steuerelement einen Aktualisierungsvorgang abgeschlossen hat.
OnUpdating(SqlDataSourceCommandEventArgs)	Löst das Updating-Ereignis aus, bevor das SqlDataSource-Steuerelement einen Aktualisierungsvorgang startet.
RaiseUnsupportedCapabilityError(DataSourceCapabilities)	Vergleicht die für einen ExecuteSelect(DataSourceSelectArguments)-Vorgang erforderlichen Funktionen mit den von der Ansicht unterstützten und wird von der RaiseUnsupportedCapabilitiesError(DataSourceView)-Methode aufgerufen.
SaveViewState()	Speichert die Änderungen am Ansichtsstatus des SqlDataSourceView Steuerelements seit dem Zeitpunkt, zu dem die Seite zurück an den Server gesendet wurde.
Select(DataSourceSelectArguments)	Ruft Daten aus der zugrunde liegenden Datenbank mithilfe der SelectCommand-SQL-Zeichenfolge und aller Parameter in der SelectParameters-Auflistung ab.
Select(DataSourceSelectArguments, DataSourceViewSelectCallback)	Ruft asynchron eine Liste der Daten aus dem zugrunde liegenden Datenspeicher ab. (Geerbt von DataSourceView)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
TrackViewState()	Bewirkt, dass das SqlDataSourceView-Objekt Änderungen an seinem Ansichtszustand nachverfolgt, damit diese im StateBag-Objekt des Steuerelements gespeichert und über Anforderungen der gleichen Seite hinweg beibehalten werden.
Update(IDictionary, IDictionary, IDictionary)	Führt mithilfe der UpdateCommand-SQL-Zeichenfolge, aller Parameter in der UpdateParameters-Auflistung sowie der Werte in den angegebenen Auflistungen `keys`, `values` und `oldValues` einen Aktualisierungsvorgang aus.
Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)	Führt einen asynchronen Aktualisierungsvorgang in der Liste der Daten aus, die das DataSourceView-Objekt darstellt. (Geerbt von DataSourceView)

Ereignisse

DataSourceViewChanged	Tritt ein, wenn sich die Datenquellenansicht geändert hat. (Geerbt von DataSourceView)
Deleted	Tritt ein, wenn ein Löschvorgang abgeschlossen ist.
Deleting	Tritt vor einem Löschvorgang ein.
Filtering	Tritt vor einem Filtervorgang auf.
Inserted	Tritt ein, wenn ein Einfügevorgang abgeschlossen wurde.
Inserting	Tritt vor einem Einfügevorgang ein.
Selected	Tritt ein, wenn ein Datenabrufvorgang abgeschlossen wurde.
Selecting	Tritt vor einem Datenabrufvorgang ein.
Updated	Tritt ein, wenn ein Aktualisierungsvorgang abgeschlossen wurde.
Updating	Tritt vor einem Aktualisierungsvorgang ein.

Explizite Schnittstellenimplementierungen

IStateManager.IsTrackingViewState	Eine Beschreibung dieses Elements finden Sie unter IsTrackingViewState.
IStateManager.LoadViewState(Object)	Eine Beschreibung dieses Elements finden Sie unter LoadViewState(Object).
IStateManager.SaveViewState()	Eine Beschreibung dieses Elements finden Sie unter SaveViewState().
IStateManager.TrackViewState()	Eine Beschreibung dieses Elements finden Sie unter TrackViewState().

Gilt für:

Teilen über