IDbDataAdapter.UpdateCommand Eigenschaft

Definition

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Assembly:

System.Data.dll

Assembly:

netstandard.dll

Ruft eine SQL-Anweisung ab, mit der Datensätze in der Datenquelle aktualisiert werden, oder legt diese fest.

public:
 property System::Data::IDbCommand ^ UpdateCommand { System::Data::IDbCommand ^ get(); void set(System::Data::IDbCommand ^ value); };

public System.Data.IDbCommand? UpdateCommand { get; set; }

public System.Data.IDbCommand UpdateCommand { get; set; }

member this.UpdateCommand : System.Data.IDbCommand with get, set

Public Property UpdateCommand As IDbCommand

Eigenschaftswert

IDbCommand

Ein IDbCommand, das während der Ausführung von Update(DataSet) verwendet wird, um Datensätze in der Datenquelle zu aktualisieren, die geänderten Zeilen im Dataset entsprechen.

Beispiele

Im folgenden Beispiel wird eine Instanz der geerbten OleDbDataAdapter Klasse erstellt und die SelectCommand eigenschaften UpdateCommand festgelegt. Es wird davon ausgegangen, dass Sie bereits ein OleDbConnection Objekt erstellt haben.

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;
}

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

    Dim dataAdapter As 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

Hinweise

Wenn Updatediese Eigenschaft nicht festgelegt ist und Primärschlüsselinformationen im DataSetBereich vorhanden sind, kann dies UpdateCommand automatisch generiert werden, wenn Sie die SelectCommand Eigenschaft eines .NET Framework Datenanbieters festlegen. Anschließend werden alle zusätzlichen Befehle, die Sie nicht festlegen, vom CommandBuilder generiert. Diese Generationslogik erfordert wichtige Spalteninformationen, die in der DataSet. Weitere Informationen finden Sie unter Generieren von Befehlen mit CommandBuilders.

Wenn UpdateCommand einem zuvor erstellten IDbCommandElement zugewiesen wird, wird dies IDbCommand nicht geklont. Der UpdateCommand Verweis auf das zuvor erstellte IDbCommand Objekt wird beibehalten.

Hinweis

Wenn die Ausführung dieses Befehls Zeilen zurückgibt, werden diese Zeilen dem DataSet.