OdbcDataAdapter.InsertCommand Propriété

Définition

Espace de noms:

System.Data.Odbc

Assembly:

System.Data.Odbc.dll

Paquet:

System.Data.Odbc v11.0.0-preview.2.26159.112

Source:

OdbcDataAdapter.cs

Obtient 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.

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é OdbcCommand 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.

Exemples

L’exemple suivant crée un OdbcDataAdapter et définit les propriétés et InsertCommand les SelectCommand propriétés. Il part du principe que vous avez déjà créé un OdbcConnection objet.

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 la InsertCommand propriété est affectée à un objet créé OdbcCommand précédemment, elle OdbcCommand n’est pas cloné. Au lieu de cela, InsertCommand conserve une référence à la création OdbcCommandprécédente.

Pendant une opération de mise à jour, s’il InsertCommand n’est pas défini et que les informations de clé primaire sont présentes dans la DataSetclasse, vous pouvez utiliser la OdbcCommandBuilder classe pour générer InsertCommandautomatiquement et des commandes supplémentaires nécessaires pour rapprocher la DataSet source de données. Pour ce faire, définissez la SelectCommand propriété du OdbcDataAdapter. La logique de génération nécessite également des informations de colonne clés à présenter dans le DataSet. Pour plus d’informations, consultez Génération de commandes avec CommandBuilders.

Note

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

Voir aussi

• DataAdapters et DataReaders