OdbcDataAdapter.InsertCommand OdbcDataAdapter.InsertCommand OdbcDataAdapter.InsertCommand OdbcDataAdapter.InsertCommand Property

Définition

Récupère ou définit une instruction SQL ou une procédure stockée utilisée pour insérer de nouveaux enregistrements dans la source de données.Gets or sets an SQL statement or stored procedure used to insert new records into the data source.

public:
 property System::Data::Odbc::OdbcCommand ^ InsertCommand { System::Data::Odbc::OdbcCommand ^ get(); void set(System::Data::Odbc::OdbcCommand ^ value); };
public System.Data.Odbc.OdbcCommand InsertCommand { get; set; }
member this.InsertCommand : System.Data.Odbc.OdbcCommand with get, set
Public Property InsertCommand As OdbcCommand

Valeur de propriété

OdbcCommand utilisé lors d’une opération de mise à jour pour insérer des enregistrements dans la source de données qui correspondent à de nouvelles lignes dans le DataSet.An OdbcCommand used during an update operation to insert records in the data source that correspond to new rows in the DataSet.

Exemples

L’exemple suivant crée un OdbcDataAdapter et définit le SelectCommand et InsertCommand propriétés.The following example creates an OdbcDataAdapter and sets the SelectCommand and InsertCommand properties. Il suppose que vous avez déjà créé un OdbcConnection objet.It assumes that you have already created an OdbcConnection object.

public static OdbcDataAdapter CreateDataAdapter(
    OdbcConnection connection)
{
    string selectCommand =
        "SELECT CustomerID, CompanyName FROM Customers";

    OdbcDataAdapter adapter = new OdbcDataAdapter(
        selectCommand, connection);
    adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey;

    // Create the Insert, Update and Delete commands.
    adapter.InsertCommand = new OdbcCommand(
        "INSERT INTO Customers (CustomerID, CompanyName) " +
        "VALUES (?, ?)");

    adapter.UpdateCommand = new OdbcCommand(
        "UPDATE Customers SET CustomerID = ?, CompanyName = ? " +
        "WHERE CustomerID = ?");

    adapter.DeleteCommand = new OdbcCommand(
        "DELETE FROM Customers WHERE CustomerID = ?");

    // Create the parameters.
    adapter.InsertCommand.Parameters.Add("@CustomerID",
        OdbcType.Char, 5, "CustomerID");
    adapter.InsertCommand.Parameters.Add("@CompanyName",
        OdbcType.VarChar, 40, "CompanyName");

    adapter.UpdateCommand.Parameters.Add("@CustomerID",
        OdbcType.Char, 5, "CustomerID");
    adapter.UpdateCommand.Parameters.Add("@CompanyName",
        OdbcType.VarChar, 40, "CompanyName");
    adapter.UpdateCommand.Parameters.Add("@oldCustomerID",
        OdbcType.Char, 5, "CustomerID").SourceVersion =
        DataRowVersion.Original;

    adapter.DeleteCommand.Parameters.Add("@CustomerID",
        OdbcType.Char, 5, "CustomerID").SourceVersion =
        DataRowVersion.Original;

    return adapter;
}
Public Function CreateDataAdapter( _
    ByVal connection As OdbcConnection) As OdbcDataAdapter

    Dim selectCommand As String = _
        "SELECT CustomerID, CompanyName FROM Customers"
    Dim adapter As OdbcDataAdapter = _
        New OdbcDataAdapter(selectCommand, connection)

    adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey

    ' Create the Insert, Update and Delete commands.
    adapter.InsertCommand = New OdbcCommand( _
        "INSERT INTO Customers (CustomerID, CompanyName) " & _
         "VALUES (?, ?)")

    adapter.UpdateCommand = New OdbcCommand( _
        "UPDATE Customers SET CustomerID = ?, CompanyName = ? " & _
        "WHERE CustomerID = ?")

    adapter.DeleteCommand = New OdbcCommand( _
        "DELETE FROM Customers WHERE CustomerID = ?")

    ' Create the parameters.
    adapter.InsertCommand.Parameters.Add( _
        "@CustomerID", OdbcType.Char, 5, "CustomerID")
    adapter.InsertCommand.Parameters.Add( _
        "@CompanyName", OdbcType.VarChar, 40, "CompanyName")

    adapter.UpdateCommand.Parameters.Add( _
        "@CustomerID", OdbcType.Char, 5, "CustomerID")
    adapter.UpdateCommand.Parameters.Add( _
        "@CompanyName", OdbcType.VarChar, 40, "CompanyName")
    adapter.UpdateCommand.Parameters.Add( _
        "@oldCustomerID", OdbcType.Char, 5, "CustomerID").SourceVersion = _
        DataRowVersion.Original

    adapter.DeleteCommand.Parameters.Add( _
        "@CustomerID", OdbcType.Char, 5, "CustomerID").SourceVersion = _
        DataRowVersion.Original

    Return adapter
End Function

Remarques

Lorsque le InsertCommand propriété est affectée à créé précédemment OdbcCommand objet, le OdbcCommand ne sont pas clonés.When the InsertCommand property is assigned to a previously created OdbcCommand object, the OdbcCommand is not cloned. Au lieu de cela, InsertCommand conserve une référence à l’élément précédemment créé OdbcCommand.Instead, InsertCommand maintains a reference to the previously created OdbcCommand.

Pendant une opération de mise à jour, si InsertCommand n’est pas un jeu et la clé primaire informations sont présentes dans le DataSet, vous pouvez utiliser la OdbcCommandBuilder classe pour générer automatiquement InsertCommandet les commandes supplémentaires nécessaires au rapprochement le DataSet à la source de données.During an update operation, if InsertCommand is not set and primary key information is present in the DataSet, you can use the OdbcCommandBuilder class to automatically generate InsertCommand, and additional commands needed to reconcile the DataSet to the data source. Pour ce faire, définissez la SelectCommand propriété de la OdbcDataAdapter.To do this, set the SelectCommand property of the OdbcDataAdapter. La logique de génération nécessite également des informations de colonne clé dans le DataSet.The generation logic also 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.

Notes

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

S’applique à

Voir aussi