IDbDataAdapter.UpdateCommand Eigenschaft

Definition

Ruft eine SQL-Anweisung ab, die zum Aktualisieren von Datensätzen in der Datenquelle verwendet wird, oder legt sie fest.Gets or sets an SQL statement used to update records in the data source.

public:
 property System::Data::IDbCommand ^ UpdateCommand { System::Data::IDbCommand ^ get(); void set(System::Data::IDbCommand ^ value); };
public System.Data.IDbCommand UpdateCommand { get; set; }
member this.UpdateCommand : System.Data.IDbCommand with get, set
Public Property UpdateCommand As IDbCommand

Eigenschaftswert

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.An IDbCommand used during Update(DataSet) to update records in the data source for modified rows in the data set.

Beispiele

Im folgenden Beispiel wird eine Instanz der geerbten OleDbDataAdapter-Klasse erstellt, und die Eigenschaften SelectCommand und UpdateCommand werden festgelegt.The following example creates an instance of the inherited OleDbDataAdapter class, and sets the SelectCommand and UpdateCommand properties. Es wird davon ausgegangen, dass Sie bereits ein OleDbConnection Objekt erstellt haben.It assumes 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 diese Eigenschaft während Updatenicht festgelegt ist und Primärschlüssel Informationen in der DataSetvorhanden sind, kann die UpdateCommand automatisch generiert werden, wenn Sie die SelectCommand-Eigenschaft eines .NET Framework Datenanbieters festlegen.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 of a .NET Framework data provider. Anschließend werden alle zusätzlichen Befehle, die Sie nicht festlegen, vom CommandBuilder generiert.Then, any additional commands that you do not set are generated by the CommandBuilder. Diese Generierungs Logik erfordert, dass Schlüssel Spalten Informationen im 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 IDbCommandzugewiesen ist, wird der IDbCommand nicht geklont.When UpdateCommand is assigned to a previously created IDbCommand, the IDbCommand is not cloned. Der UpdateCommand verwaltet einen Verweis auf das zuvor erstellte IDbCommand-Objekt.The UpdateCommand maintains a reference to the previously created IDbCommand object.

Hinweis

Wenn die Ausführung dieses Befehlszeilen zurückgibt, werden diese Zeilen der DataSethinzugefügt.If execution of this command returns rows, these rows are added to the DataSet.

Gilt für: