IDbDataAdapter.InsertCommand Propriété

Définition

Espace de noms:

System.Data

Assembly:

System.Data.Common.dll

Obtient ou définit une instruction SQL utilisée pour insérer de nouveaux enregistrements dans la source de données.

public:
 property System::Data::IDbCommand ^ InsertCommand { System::Data::IDbCommand ^ get(); void set(System::Data::IDbCommand ^ value); };

public System.Data.IDbCommand? InsertCommand { get; set; }

member this.InsertCommand : System.Data.IDbCommand with get, set

Public Property InsertCommand As IDbCommand

Valeur de propriété

IDbCommand

IDbCommand utilisé pendant Update(DataSet) pour insérer des enregistrements dans la source de données pour les nouvelles lignes du groupe de données.

Exemples

L’exemple suivant crée une instance de la classe héritée OleDbDataAdapter et définit les SelectCommand propriétés et InsertCommand . Elle suppose que vous avez déjà créé un OleDbConnection objet.

public static OleDbDataAdapter CreateCustomerAdapter(
    OleDbConnection connection)
{
    OleDbDataAdapter adapter = new OleDbDataAdapter();
    OleDbCommand command;

    // Create the SelectCommand.
    command = new OleDbCommand("SELECT CustomerID FROM Customers " +
        "WHERE Country = ? AND City = ?", connection);

    command.Parameters.Add("Country", OleDbType.VarChar, 15);
    command.Parameters.Add("City", OleDbType.VarChar, 15);

    adapter.SelectCommand = command;

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

    command.Parameters.Add(
        "CustomerID", OleDbType.Char, 5, "CustomerID");
    command.Parameters.Add(
        "CompanyName", OleDbType.VarChar, 40, "CompanyName");

    adapter.InsertCommand = command;
    return adapter;
}

Public Shared Function CreateCustomerAdapter( _
    connection As OleDbConnection) As OleDbDataAdapter 
  
    Dim adapter As New OleDbDataAdapter()
    Dim command As OleDbCommand

    ' Create the SelectCommand.
    command = New OleDbCommand("SELECT CustomerID FROM Customers " & _
        "WHERE Country = ? AND City = ?", connection)

    command.Parameters.Add("Country", OleDbType.VarChar, 15)
    command.Parameters.Add("City", OleDbType.VarChar, 15)

    adapter.SelectCommand = command

    ' Create the InsertCommand.
    command = New OleDbCommand( _
        "INSERT INTO Customers (CustomerID, CompanyName) " & _
        "VALUES (?, ?)", connection)

    command.Parameters.Add( _
        "CustomerID", OleDbType.Char, 5, "CustomerID")
    command.Parameters.Add( _
        "CompanyName", OleDbType.VarChar, 40, "CompanyName")

    adapter.InsertCommand = command
    Return adapter
End Function

Remarques

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

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

Notes

Si l’exécution de cette commande retourne des lignes, ces lignes peuvent être ajoutées à en fonction de la DataSet façon dont vous définissez la UpdatedRowSource propriété de l’objet IDbCommand .