OleDbDataAdapter.UpdateCommand Eigenschaft

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

public System.Data.OleDb.OleDbCommand? UpdateCommand { get; set; }

[System.Data.DataSysDescription("DbDataAdapter_UpdateCommand")]
public System.Data.OleDb.OleDbCommand UpdateCommand { get; set; }

public System.Data.OleDb.OleDbCommand UpdateCommand { get; set; }

member this.UpdateCommand : System.Data.OleDb.OleDbCommand with get, set

[<System.Data.DataSysDescription("DbDataAdapter_UpdateCommand")>]
member this.UpdateCommand : System.Data.OleDb.OleDbCommand with get, set

Public Property UpdateCommand As OleDbCommand

Eigenschaftswert

Wird OleDbCommand während der Aktualisierung von Update(DataSet) Datensätzen in der Datenquelle verwendet, die geänderten Zeilen in der DataSetDatenquelle entsprechen.

Attribute

DataSysDescriptionAttribute

Beispiele

Im folgenden Beispiel wird eine OleDbDataAdapter und die SelectCommand Eigenschaften erstellt und 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 in der DataSetDatei vorhanden sind, kann dies UpdateCommand automatisch generiert werden, wenn Sie die SelectCommand Eigenschaft festlegen und die OleDbCommandBuilder. Anschließend werden alle zusätzlichen Befehle, die Sie nicht festlegen, von dem OleDbCommandBuildergeneriert. Diese Generierungslogik erfordert, dass wichtige Spalteninformationen in der DataSet. Weitere Informationen finden Sie unter Generieren von Befehlen mit CommandBuilder-Objekten.

Wenn UpdateCommand einem zuvor erstellten OleDbCommandElement zugewiesen wird, wird dies OleDbCommand nicht geklont. Der UpdateCommand Verwaltet einen Verweis auf das zuvor erstellte OleDbCommand Objekt.