OleDbDataAdapter.UpdateCommand-Eigenschaft

Ruft eine SQL-Anweisung oder gespeicherte Prozedur ab, um Datensätze in der Datenquelle zu aktualisieren, oder legt diese fest.

Namespace: System.Data.OleDb
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
Public Property UpdateCommand As OleDbCommand
'Usage
Dim instance As OleDbDataAdapter
Dim value As OleDbCommand

value = instance.UpdateCommand

instance.UpdateCommand = value

public OleDbCommand UpdateCommand { get; set; }

public:
property OleDbCommand^ UpdateCommand {
    OleDbCommand^ get ();
    void set (OleDbCommand^ value);
}

/** @property */
public OleDbCommand get_UpdateCommand ()

/** @property */
public void set_UpdateCommand (OleDbCommand value)

public function get UpdateCommand () : OleDbCommand

public function set UpdateCommand (value : OleDbCommand)

Eigenschaftenwert

Ein OleDbCommand, das während der Ausführung von Update zum Aktualisieren von Datensätzen in der Datenquelle verwendet wird, die den geänderten Zeilen im DataSet entsprechen.

Hinweise

Während der Ausführung von Update kann, wenn diese Eigenschaft nicht festgelegt wurde und Primärschlüsselinformationen im DataSet vorhanden sind, der UpdateCommand automatisch generiert werden, wenn Sie die SelectCommand-Eigenschaft festlegen und OleDbCommandBuilder verwenden. Anschließend werden alle zusätzlichen Befehle, die Sie nicht festlegen, von OleDbCommandBuilder generiert. Für diese Generierungslogik müssen im DataSet Schlüsselspalteninformationen vorhanden sein. Weitere Informationen finden Sie unter Automatisches Generieren von Befehlen.

Wenn UpdateCommand einem zuvor erstellten OleDbCommand zugeordnet wird, wird der OleDbCommand nicht geklont. Der UpdateCommand verwaltet einen Verweis auf das zuvor erstellte OleDbCommand-Objekt.

Beispiel

Im folgenden Beispiel werden ein OleDbDataAdapter erstellt sowie die SelectCommand-Eigenschaft und die UpdateCommand-Eigenschaft festgelegt. Es wird davon ausgegangen, dass bereits ein OleDbConnection-Objekt erstellt wurde.

Private Function CreateCustomerAdapter( _
    ByVal connection As OleDbConnection) As OleDbDataAdapter

    Dim dataAdapter As OleDbDataAdapter = New OleDbDataAdapter()
    Dim command As OleDbCommand
    Dim parameter As OleDbParameter

    ' Create the SelectCommand.
    command = New OleDbCommand("SELECT * FROM dbo.Customers " & _
        "WHERE Country = ? AND City = ?", connection)

    command.Parameters.Add("Country", OleDbType.VarChar, 15)
    command.Parameters.Add("City", OleDbType.VarChar, 15)

    dataAdapter.SelectCommand = command

    ' Create the UpdateCommand.
    command = New OleDbCommand("UPDATE dbo.Customers " & _
        "SET CustomerID = ?, CompanyName = ? " & _
        "WHERE CustomerID = ?", connection)

    command.Parameters.Add( _
        "CustomerID", OleDbType.Char, 5, "CustomerID")
    command.Parameters.Add( _
        "CompanyName", OleDbType.VarChar, 40, "CompanyName")

    parameter = command.Parameters.Add( _
        "oldCustomerID", OleDbType.Char, 5, "CustomerID")
    parameter.SourceVersion = DataRowVersion.Original

    dataAdapter.UpdateCommand = command

    Return dataAdapter
End Function

private static OleDbDataAdapter CreateCustomerAdapter(
    OleDbConnection connection)
{
    OleDbDataAdapter dataAdapter = new OleDbDataAdapter();
    OleDbCommand command;
    OleDbParameter parameter;

    // Create the SelectCommand.
    command = new OleDbCommand("SELECT * FROM dbo.Customers " +
        "WHERE Country = ? AND City = ?", connection);

    command.Parameters.Add("Country", OleDbType.VarChar, 15);
    command.Parameters.Add("City", OleDbType.VarChar, 15);

    dataAdapter.SelectCommand = command;

    // Create the UpdateCommand.
    command = new OleDbCommand(
        "UPDATE dbo.Customers SET CustomerID = ?, CompanyName = ? " +
        "WHERE CustomerID = ?", connection);

    command.Parameters.Add(
        "CustomerID", OleDbType.Char, 5, "CustomerID");
    command.Parameters.Add(
        "CompanyName", OleDbType.VarChar, 40, "CompanyName");

    parameter = command.Parameters.Add(
        "oldCustomerID", OleDbType.Char, 5, "CustomerID");
    parameter.SourceVersion = DataRowVersion.Original;

    dataAdapter.UpdateCommand = command;

    return dataAdapter;
}

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

OleDbDataAdapter-Klasse
OleDbDataAdapter-Member
System.Data.OleDb-Namespace

Weitere Ressourcen

Arbeiten mit DataAdapters