SqlDataSourceView Klasse

Definition

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
SqlDataSourceView
Abgeleitet
Implementiert

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:

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:

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:

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:

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, DataSourceViewOperationCallback)

Führt einen asynchronen Löschvorgang in der Liste der Daten aus, die das DataSourceView-Objekt darstellt.

(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.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
ExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)

Führt den angegebenen Befehl aus.

(Geerbt von DataSourceView)
ExecuteCommand(String, IDictionary, IDictionary)

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, DataSourceViewOperationCallback)

Führt einen asynchronen Einfügevorgang in der Liste der Daten aus, die das DataSourceView-Objekt darstellt.

(Geerbt von DataSourceView)
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.

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, DataSourceViewSelectCallback)

Ruft asynchron eine Liste der Daten aus dem zugrunde liegenden Datenspeicher ab.

(Geerbt von DataSourceView)
Select(DataSourceSelectArguments)

Ruft Daten aus der zugrunde liegenden Datenbank mithilfe der SelectCommand-SQL-Zeichenfolge und aller Parameter in der SelectParameters-Auflistung ab.

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, DataSourceViewOperationCallback)

Führt einen asynchronen Aktualisierungsvorgang in der Liste der Daten aus, die das DataSourceView-Objekt darstellt.

(Geerbt von DataSourceView)
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.

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:

Weitere Informationen