SqlDataAdapter.UpdateCommand Propriété

Définition

Espace de noms:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paquet:

Microsoft.Data.SqlClient v5.2.0

Obtient ou définit une instruction Transact-SQL ou une procédure stockée pour mettre à jour des enregistrements dans la source de données.

public:
 property Microsoft::Data::SqlClient::SqlCommand ^ UpdateCommand { Microsoft::Data::SqlClient::SqlCommand ^ get(); void set(Microsoft::Data::SqlClient::SqlCommand ^ value); };

public Microsoft.Data.SqlClient.SqlCommand UpdateCommand { get; set; }

member this.UpdateCommand : Microsoft.Data.SqlClient.SqlCommand with get, set

Public Property UpdateCommand As SqlCommand

Valeur de propriété

SqlCommand

SqlCommand employé lors de l'utilisation de Update(DataSet) pour mettre à jour dans la base de données des enregistrements qui correspondent aux lignes modifiées dans DataSet.

Exemples

L’exemple suivant crée un SqlDataAdapter et définit les SelectCommandpropriétés , InsertCommandUpdateCommand et DeleteCommand . Elle suppose que vous avez déjà créé un SqlConnection objet.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
    }
    public static SqlDataAdapter CreateCustomerAdapter(
        SqlConnection connection)
    {
        SqlDataAdapter adapter = new SqlDataAdapter();

        // Create the SelectCommand.
        SqlCommand command = new SqlCommand("SELECT * FROM Customers " +
            "WHERE Country = @Country AND City = @City", connection);

        // Add the parameters for the SelectCommand.
        command.Parameters.Add("@Country", SqlDbType.NVarChar, 15);
        command.Parameters.Add("@City", SqlDbType.NVarChar, 15);

        adapter.SelectCommand = command;

        // Create the InsertCommand.
        command = new SqlCommand(
            "INSERT INTO Customers (CustomerID, CompanyName) " +
            "VALUES (@CustomerID, @CompanyName)", connection);

        // Add the parameters for the InsertCommand.
        command.Parameters.Add("@CustomerID", SqlDbType.NChar, 5, "CustomerID");
        command.Parameters.Add("@CompanyName", SqlDbType.NVarChar, 40, "CompanyName");

        adapter.InsertCommand = command;

        // Create the UpdateCommand.
        command = new SqlCommand(
            "UPDATE Customers SET CustomerID = @CustomerID, CompanyName = @CompanyName " +
            "WHERE CustomerID = @oldCustomerID", connection);

        // Add the parameters for the UpdateCommand.
        command.Parameters.Add("@CustomerID", SqlDbType.NChar, 5, "CustomerID");
        command.Parameters.Add("@CompanyName", SqlDbType.NVarChar, 40, "CompanyName");
        SqlParameter parameter = command.Parameters.Add(
            "@oldCustomerID", SqlDbType.NChar, 5, "CustomerID");
        parameter.SourceVersion = DataRowVersion.Original;

        adapter.UpdateCommand = command;

        // Create the DeleteCommand.
        command = new SqlCommand(
            "DELETE FROM Customers WHERE CustomerID = @CustomerID", connection);

        // Add the parameters for the DeleteCommand.
        parameter = command.Parameters.Add(
            "@CustomerID", SqlDbType.NChar, 5, "CustomerID");
        parameter.SourceVersion = DataRowVersion.Original;

        adapter.DeleteCommand = command;

        return adapter;
    }
}

Remarques

Pendant Update, si cette propriété n’est pas définie et que des informations de clé primaire sont présentes dans , DataSetle UpdateCommand peut être généré automatiquement si vous définissez la SelectCommand propriété et utilisez le SqlCommandBuilder. Ensuite, toutes les commandes supplémentaires que vous ne définissez pas sont générées par le SqlCommandBuilder. Cette logique de génération nécessite que les informations de colonne clés soient présentes dans le DataSet. Pour plus d’informations, consultez Génération de commandes avec CommandBuilders.

Quand UpdateCommand est affecté à un créé précédemment SqlCommand, le n’est SqlCommand pas cloné. Conserve UpdateCommand une référence à l’objet créé SqlCommand précédemment.

Notes

Si l’exécution de cette commande retourne des lignes, les lignes mises à jour peuvent être fusionnées avec le en fonction de la DataSet façon dont vous définissez la propriété UpdatedRowSource de l’objet SqlCommand .

Pour chaque colonne que vous propagez à la source de données sur Update, un paramètre doit être ajouté à InsertCommand, UpdateCommandou DeleteCommand.

La SourceColumn propriété du paramètre doit être définie sur le nom de la colonne. Cela indique que la valeur du paramètre n’est pas définie manuellement, mais qu’elle provient de la colonne particulière de la ligne actuellement traitée.