DbDataAdapter.InsertCommand Propriété

Définition

Espace de noms:

System.Data.Common

Assembly:

System.Data.Common.dll

Source:

DbDataAdapter.cs

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

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

[System.ComponentModel.Browsable(false)]
public System.Data.Common.DbCommand? InsertCommand { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.InsertCommand : System.Data.Common.DbCommand with get, set

Public Property InsertCommand As DbCommand

Valeur de propriété

DbCommand

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.

Attributs

BrowsableAttribute

Exemples

L’exemple suivant crée la classe OleDbDataAdapter dérivée et définit certaines de ses propriétés.

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 est généré automatiquement.

Voir aussi

• Manipulation de données (ADO.NET)
• DbProviderFactories (ADO.NET)
• Vue d'ensemble d’ADO.NET