Auf Englisch lesen

Freigeben über


OdbcDataAdapter.UpdateCommand Eigenschaft

Definition

Ruft eine zum Aktualisieren von Datensätzen in der Datenquelle verwendete SQL-Anweisung oder gespeicherte Prozedur ab oder legt diese fest.

C#
public System.Data.Odbc.OdbcCommand? UpdateCommand { get; set; }
C#
public System.Data.Odbc.OdbcCommand UpdateCommand { get; set; }

Eigenschaftswert

Ein OdbcCommand, der bei einem Vorgang zum Aktualisieren von Datensätzen in der Datenquelle verwendet wird, die geänderten Zeilen im DataSet entsprechen.

Beispiele

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

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

Hinweise

Wenn UpdateCommand einem zuvor erstellten OdbcCommandzugewiesen wird, wird der OdbcCommand nicht geklont. Stattdessen verwaltet die UpdateCommand einen Verweis auf das zuvor erstellte OdbcCommand -Objekt.

Wenn UpdateCommand während eines Aktualisierungsvorgangs nicht festgelegt ist und Primärschlüsselinformationen in DataSetvorhanden sind, können Sie die OdbcCommandBuilder -Klasse verwenden, um automatisch zu generieren UpdateCommand, und zusätzliche Befehle, die zum Abgleichen von mit DataSet der Datenquelle erforderlich sind. Legen Sie dazu die SelectCommand -Eigenschaft von OdbcDataAdapterfest. Die Generierungslogik erfordert auch, dass wichtige Spalteninformationen im DataSetvorhanden sind. Weitere Informationen finden Sie unter Generieren von Befehlen mit CommandBuilder-Objekten.

Hinweis

Wenn die Ausführung dieses Befehls Zeilen zurückgibt, können diese Zeilen mit dem DataSet zusammengeführt werden, je nachdem, wie Sie die UpdatedRowSource -Eigenschaft des OdbcCommand -Objekts festlegen.

Gilt für:

Produkt Versionen
.NET 8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0 (package-provided)