Diese Dokumentation wurde archiviert und wird nicht länger gepflegt.

SqlDataSourceView.ExecuteUpdate-Methode

Hinweis: Diese Methode ist neu in .NET Framework, Version 2.0.

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.

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

protected override int ExecuteUpdate (
	IDictionary keys,
	IDictionary values,
	IDictionary oldValues
)
protected int ExecuteUpdate (
	IDictionary keys, 
	IDictionary values, 
	IDictionary oldValues
)
protected override function ExecuteUpdate (
	keys : IDictionary, 
	values : IDictionary, 
	oldValues : IDictionary
) : int

Parameter

keys

Ein IDictionary mit Primärschlüsseln, die mit der UpdateCommand-Eigenschaft zum Ausführen des Aktualisierungsvorgangs für die Datenbank verwendet werden. Wenn der Abfrage keine Schlüssel zugeordnet sind oder die UpdateCommand-Eigenschaft keine parametrisierte SQL-Abfrage ist, wird NULL (Nothing in Visual Basic) übergeben.

values

Ein IDictionary mit Werten, die mit der UpdateCommand-Eigenschaft zum Ausführen des Aktualisierungsvorgangs für die Datenbank verwendet werden. Wenn der Abfrage keine Parameter zugeordnet sind oder der UpdateCommand keine parametrisierte SQL-Abfrage ist, wird NULL (Nothing in Visual Basic) übergeben.

oldValues

Ein IDictionary, das die ursprünglichen Werte in der Datenbank darstellt. Wenn der Abfrage keine Parameter zugeordnet sind oder die UpdateCommand-Eigenschaft keine parametrisierte SQL-Abfrage ist, wird NULL (Nothing in Visual Basic) übergeben.

Rückgabewert

Ein Wert, der die Anzahl der aktualisierten Zeilen in der zugrunde liegenden Datenbank darstellt.

AusnahmetypBedingung

InvalidOperationException

Die SqlDataSource kann keine Verbindung mit der zugrunde liegenden Datenquelle herstellen.

– oder –

Die ConflictDetection-Eigenschaft wird auf den CompareAllValues-Wert festgelegt, und es werden keine oldValues-Parameter übergeben.

HttpException

Der aktuelle Benutzer verfügt nicht über die erforderlichen Berechtigungen für den Zugriff auf die Datenbank.

NotSupportedException

Der Wert der CanUpdate-Eigenschaft ist false.

Die SqlDataSourceView-Klasse implementiert die geerbte ExecuteUpdate-Methode, um Daten in einer Datenbank zu aktualisieren. Entwickler von Seiten und Ersteller von datengebundenen Steuerelementen rufen die ExecuteUpdate-Methode nicht direkt auf, sondern verwenden stattdessen die öffentlich verfügbare Update-Methode.

Die in der keys-Auflistung und der values-Auflistung enthaltenen Werte werden ausgewertet und mit allen in der UpdateParameters-Auflistung enthaltenen Werten zusammengeführt. Wenn die ConflictDetection-Eigenschaft auf CompareAllValues festgelegt ist, werden die in der oldValues-Auflistung enthaltenen Werte mit der OldValuesParameterFormatString formatiert und ebenfalls zusammengeführt.

Vor dem Ausführen des Aktualisierungsvorgangs wird die OnUpdating-Methode aufgerufen, um das Updating-Ereignis auszulösen. Sie können dieses Ereignis behandeln, um die Werte der Parameter zu untersuchen und eine Vorverarbeitung vor der Aktualisierung auszuführen.

Zum Ausführen dieses Vorgangs erstellt die SqlDataSourceView mithilfe des UpdateCommand-Texts und aller zugeordneten UpdateParameters-Eigenschaften ein DbCommand-Objekt und führt dann das DbCommand-Objekt für die zugrunde liegende Datenbank aus. Nach Abschluss des Vorgangs wird die OnUpdated-Methode aufgerufen, um das Updated-Ereignis auszulösen. Sie können eine Ereignisbehandlung definieren, mit der Sie Rückgabewerte und Fehlercodes überprüfen und eine möglicherweise erforderliche Nachbearbeitung durchführen können.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

.NET Framework

Unterstützt in: 2.0
Anzeigen: