Freigeben über


OdbcDataAdapter.UpdateCommand Eigenschaft

Definition

Dient zum Abrufen oder Festlegen einer SQL-Anweisung oder einer gespeicherten Prozedur, die zum Aktualisieren von Datensätzen in der Datenquelle verwendet wird.

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

Eigenschaftswert

Ein OdbcCommand Verwendeter während eines Aktualisierungsvorgangs zum Aktualisieren von Datensätzen in der Datenquelle, die geänderten Zeilen in der DataSet.

Beispiele

Im folgenden Beispiel wird eine OdbcDataAdapter und die SelectCommand Eigenschaften erstellt und UpdateCommand festgelegt. Es wird davon ausgegangen, dass Sie bereits ein OdbcConnection Objekt erstellt haben.

public static OdbcDataAdapter CreateDataAdapter(
    OdbcConnection connection)
{
    string selectCommand =
        "SELECT CustomerID, CompanyName FROM Customers";

    OdbcDataAdapter adapter = new OdbcDataAdapter(
        selectCommand, connection);
    adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey;

    // Create the Insert, Update and Delete commands.
    adapter.InsertCommand = new OdbcCommand(
        "INSERT INTO Customers (CustomerID, CompanyName) " +
        "VALUES (?, ?)");

    adapter.UpdateCommand = new OdbcCommand(
        "UPDATE Customers SET CustomerID = ?, CompanyName = ? " +
        "WHERE CustomerID = ?");

    adapter.DeleteCommand = new OdbcCommand(
        "DELETE FROM Customers WHERE CustomerID = ?");

    // Create the parameters.
    adapter.InsertCommand.Parameters.Add("@CustomerID",
        OdbcType.Char, 5, "CustomerID");
    adapter.InsertCommand.Parameters.Add("@CompanyName",
        OdbcType.VarChar, 40, "CompanyName");

    adapter.UpdateCommand.Parameters.Add("@CustomerID",
        OdbcType.Char, 5, "CustomerID");
    adapter.UpdateCommand.Parameters.Add("@CompanyName",
        OdbcType.VarChar, 40, "CompanyName");
    adapter.UpdateCommand.Parameters.Add("@oldCustomerID",
        OdbcType.Char, 5, "CustomerID").SourceVersion =
        DataRowVersion.Original;

    adapter.DeleteCommand.Parameters.Add("@CustomerID",
        OdbcType.Char, 5, "CustomerID").SourceVersion =
        DataRowVersion.Original;

    return adapter;
}
Public Function CreateDataAdapter( _
    ByVal connection As OdbcConnection) As OdbcDataAdapter

    Dim selectCommand As String = _
        "SELECT CustomerID, CompanyName FROM Customers"
    Dim adapter As OdbcDataAdapter = _
        New OdbcDataAdapter(selectCommand, connection)

    adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey

    ' Create the Insert, Update and Delete commands.
    adapter.InsertCommand = New OdbcCommand( _
        "INSERT INTO Customers (CustomerID, CompanyName) " & _
         "VALUES (?, ?)")

    adapter.UpdateCommand = New OdbcCommand( _
        "UPDATE Customers SET CustomerID = ?, CompanyName = ? " & _
        "WHERE CustomerID = ?")

    adapter.DeleteCommand = New OdbcCommand( _
        "DELETE FROM Customers WHERE CustomerID = ?")

    ' Create the parameters.
    adapter.InsertCommand.Parameters.Add( _
        "@CustomerID", OdbcType.Char, 5, "CustomerID")
    adapter.InsertCommand.Parameters.Add( _
        "@CompanyName", OdbcType.VarChar, 40, "CompanyName")

    adapter.UpdateCommand.Parameters.Add( _
        "@CustomerID", OdbcType.Char, 5, "CustomerID")
    adapter.UpdateCommand.Parameters.Add( _
        "@CompanyName", OdbcType.VarChar, 40, "CompanyName")
    adapter.UpdateCommand.Parameters.Add( _
        "@oldCustomerID", OdbcType.Char, 5, "CustomerID").SourceVersion = _
        DataRowVersion.Original

    adapter.DeleteCommand.Parameters.Add( _
        "@CustomerID", OdbcType.Char, 5, "CustomerID").SourceVersion = _
        DataRowVersion.Original

    Return adapter
End Function

Hinweise

Wenn UpdateCommand einem zuvor erstellten OdbcCommandElement zugewiesen wird, wird dies OdbcCommand nicht geklont. UpdateCommand Stattdessen wird ein Verweis auf das zuvor erstellte Objekt beibehaltenOdbcCommand.

Bei einem Aktualisierungsvorgang können Sie, wenn UpdateCommand sie nicht festgelegt ist und Primärschlüsselinformationen in der DataSetKlasse vorhanden sind, die Klasse verwenden OdbcCommandBuilder , um automatisch zu generieren UpdateCommand, und zusätzliche Befehle, die erforderlich sind, um die DataSet Datenquelle abzugleichen. Legen Sie dazu die SelectCommand Eigenschaft der OdbcDataAdapter. Für die Generierungslogik sind außerdem wichtige Spalteninformationen erforderlich, die DataSetim Bereich vorhanden sind. Weitere Informationen finden Sie unter Generieren von Befehlen mit CommandBuilder-Objekten.

Hinweis

Wenn die Ausführung dieses Befehls Zeilen zurückgibt, werden diese Zeilen möglicherweise mit der DataSet abhängigen Festlegung der UpdatedRowSource Eigenschaft des OdbcCommand Objekts zusammengeführt.

Gilt für: