IDbDataAdapter.InsertCommand IDbDataAdapter.InsertCommand IDbDataAdapter.InsertCommand IDbDataAdapter.InsertCommand Property

Définition

Obtient ou définit une instruction SQL utilisée pour insérer de nouveaux enregistrements dans la source de données.Gets or sets an SQL statement used to insert new records into the data source.

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 utilisé pendant Update(DataSet) pour insérer des enregistrements dans la source de données pour les nouvelles lignes du groupe de données.An IDbCommand used during Update(DataSet) to insert records in the data source for new rows in the data set.

Exemples

L’exemple suivant crée une instance de la classe OleDbDataAdapter héritée et définit les SelectCommand propriétés InsertCommand et.The following example creates an instance of the inherited OleDbDataAdapter class, and sets the SelectCommand and InsertCommand properties. Il part du principe que vous avez déjà OleDbConnection créé un objet.It assumes you have already created an OleDbConnection object.

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 OleDbDataAdapter = 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 les informations de clé primaire DataSetsont présentes InsertCommand dans le, le peut être généré automatiquement SelectCommand si vous définissez la 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 InsertCommand can be generated automatically if you set the SelectCommand property of a .NET Framework data provider. Ensuite, toutes les commandes supplémentaires 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 requiert que les informations sur les colonnes clés DataSetsoient présentes dans le.This generation logic requires key column information to be present in the DataSet. Pour plus d’informations, consultez génération de commandes avec CommandBuilders.For more information see Generating Commands with CommandBuilders.

Lorsque InsertCommand est assigné à un précédemment créé IDbCommand, le IDbCommand n’est pas cloné.When InsertCommand is assigned to a previously created IDbCommand, the IDbCommand is not cloned. Le InsertCommand gère une référence à l’objet créé IDbCommand précédemment.The InsertCommand maintains a reference to the previously created IDbCommand object.

Notes

Si l’exécution de cette commande retourne des lignes, ces lignes peuvent être ajoutées DataSet à en fonction de la façon dont UpdatedRowSource vous avez défini IDbCommand la propriété de l’objet.If execution of this command returns rows, these rows may be added to the DataSet depending on how you set the UpdatedRowSource property of the IDbCommand object.

S’applique à