IDbDataAdapter.UpdateCommand IDbDataAdapter.UpdateCommand IDbDataAdapter.UpdateCommand IDbDataAdapter.UpdateCommand Property

Définition

Obtient ou définit une instruction SQL utilisée pour mettre à jour les enregistrements dans la source de données.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

Valeur de propriété

IDbCommand utilisé pendant Update(DataSet) pour mettre à jour les enregistrements de la source de données pour des lignes modifiées dans le groupe de données.An IDbCommand used during Update(DataSet) to update records in the data source for modified rows in the data set.

Exemples

L’exemple suivant crée une instance de l’élément hérité OleDbDataAdapter classe et affecte le SelectCommand et UpdateCommand propriétés.The following example creates an instance of the inherited OleDbDataAdapter class, and sets the SelectCommand and UpdateCommand properties. Il part du principe que vous avez déjà créé un OleDbConnection objet.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 OleDbDataAdapter = 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

Remarques

Au cours de Update, si cette propriété n’est pas définie et informations de clé primaire sont présentes dans le DataSet, le UpdateCommand peut être généré automatiquement si vous définissez le SelectCommand propriété d’un fournisseur de données .NET Framework.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. Ensuite, toutes les commandes que vous ne définissez pas sont générées par CommandBuilder.Then, any additional commands that you do not set are generated by the CommandBuilder. Cette logique de génération nécessite des informations de colonne clé dans le DataSet.This generation logic 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.

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

Notes

Si l’exécution de cette commande retourne des lignes, ces lignes sont ajoutées à la DataSet.If execution of this command returns rows, these rows are added to the DataSet.

S’applique à