OdbcDataAdapter.UpdateCommand OdbcDataAdapter.UpdateCommand OdbcDataAdapter.UpdateCommand OdbcDataAdapter.UpdateCommand Property

Définition

Récupère ou définit une instruction SQL ou une procédure stockée utilisée pour mettre à jour les enregistrements dans la source de données.Gets or sets an SQL statement or stored procedure used to update records in the data source.

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; }
member this.UpdateCommand : System.Data.Odbc.OdbcCommand with get, set
Public Property UpdateCommand As OdbcCommand

Valeur de propriété

Un OdbcCommand utilisé lors d’une opération de mise à jour pour mettre à jour les enregistrements dans la source de données qui correspondent à des lignes modifiées dans le DataSet.An OdbcCommand used during an update operation to update records in the data source that correspond to modified rows in the DataSet.

Exemples

L’exemple suivant crée un OdbcDataAdapter et définit le SelectCommand et UpdateCommand propriétés.The following example creates an OdbcDataAdapter and sets the SelectCommand and UpdateCommand properties. Il suppose que vous avez déjà créé un OdbcConnection objet.It assumes that you have already created an OdbcConnection object.

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

Remarques

Lorsque UpdateCommand est affecté à un créé précédemment OdbcCommand, le OdbcCommand ne sont pas clonés.When UpdateCommand is assigned to a previously created OdbcCommand, the OdbcCommand is not cloned. Au lieu de cela, le UpdateCommand conserve une référence à l’élément précédemment créé OdbcCommand objet.Instead, the UpdateCommand maintains a reference to the previously created OdbcCommand object.

Pendant une opération de mise à jour, si UpdateCommand n’est pas un jeu et la clé primaire informations sont présentes dans le DataSet, vous pouvez utiliser la OdbcCommandBuilder classe pour générer automatiquement UpdateCommandet les commandes supplémentaires nécessaires au rapprochement le DataSet à la source de données.During an update operation, if UpdateCommand is not set and primary key information is present in the DataSet, you can use the OdbcCommandBuilder class to automatically generate UpdateCommand, and additional commands needed to reconcile the DataSet to the data source. Pour ce faire, définissez la SelectCommand propriété de la OdbcDataAdapter.To do this, set the SelectCommand property of the OdbcDataAdapter. La logique de génération nécessite également des informations de colonne clé dans le DataSet.The generation logic also requires key column information to be present in the DataSet. Pour plus d’informations, consultez générant des commandes avec CommandBuilders.For more information, see Generating Commands with CommandBuilders.

Notes

Si l’exécution de cette commande retourne des lignes, ces lignes peuvent être fusionnées avec les DataSet selon la façon dont vous définissez la UpdatedRowSource propriété de la OdbcCommand objet.If execution of this command returns rows, these rows may be merged with the DataSet depending upon how you set the UpdatedRowSource property of the OdbcCommand object.

S’applique à