OleDbDataAdapter.UpdateCommand Eigenschaft

Definition

Ruft eine zum Aktualisieren von Datensätzen in der Datenquelle verwendete SQL-Anweisung oder gespeicherte Prozedur ab oder legt diese fest.Gets or sets an SQL statement or stored procedure used to update records in the data source.

public:
 property System::Data::OleDb::OleDbCommand ^ UpdateCommand { System::Data::OleDb::OleDbCommand ^ get(); void set(System::Data::OleDb::OleDbCommand ^ value); };
[System.Data.DataSysDescription("DbDataAdapter_UpdateCommand")]
public System.Data.OleDb.OleDbCommand UpdateCommand { get; set; }
member this.UpdateCommand : System.Data.OleDb.OleDbCommand with get, set
Public Property UpdateCommand As OleDbCommand

Eigenschaftswert

Ein OleDbCommand, der beim Update(DataSet) zum Aktualisieren von Datensätzen in der Datenquelle verwendet wird, die geänderten Zeilen im DataSet entsprechen.An OleDbCommand used during Update(DataSet) to update records in the data source that correspond to modified rows in the DataSet.

Attribute

Beispiele

Im folgenden Beispiel wird ein OleDbDataAdapter erstellt und die SelectCommand - UpdateCommand und-Eigenschaften festgelegt.The following example creates an OleDbDataAdapter and sets the SelectCommand and UpdateCommand properties. Es wird davon ausgegangen, dass Sie bereits OleDbConnection ein Objekt erstellt haben.It assumes that you have already created an OleDbConnection object.

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 während nicht festgelegt ist und Primärschlüssel Informationen DataSetin vorhanden sind, UpdateCommand kann automatisch generiert werden, OleDbCommandBuilderWenn Sie die SelectCommand -Eigenschaft festlegen und verwenden.During Update, if this property is not set and primary key information is present in the DataSet, the UpdateCommand can be generated automatically if you set the SelectCommand property and use the OleDbCommandBuilder. Anschließend werden alle zusätzlichen Befehle, die Sie nicht festlegen, von OleDbCommandBuildergeneriert.Then, any additional commands that you do not set are generated by the OleDbCommandBuilder. Diese Generierungs Logik erfordert, dass Schlüssel Spalten Informationen in DataSetvorhanden sind.This generation logic requires key column information to be present in the DataSet. Weitere Informationen finden Sie unter Erstellen von Befehlen mit CommandBuilder.For more information, see Generating Commands with CommandBuilders.

Wenn UpdateCommand einem zuvor erstellten OleDbCommandzugewiesen ist, wird der OleDbCommand nicht geklont.When UpdateCommand is assigned to a previously created OleDbCommand, the OleDbCommand is not cloned. Verwaltet einen Verweis auf das zuvor erstellte OleDbCommand -Objekt. UpdateCommandThe UpdateCommand maintains a reference to the previously created OleDbCommand object.

Hinweis

Wenn die Ausführung dieses Befehlszeilen zurückgibt, können diese Zeilen mit dem DataSet zusammengeführt werden, je nachdem, wie Sie die OleDbCommand UpdatedRowSource -Eigenschaft des-Objekts festlegen.If execution of this command returns rows, these rows may be merged with the DataSet depending on how you set the UpdatedRowSource property of the OleDbCommand object.

Gilt für: