OleDbDataAdapter.InsertCommand Vlastnost

Definice

Obor názvů:

System.Data.OleDb

Sestavení:

System.Data.dll

Získá nebo nastaví příkaz SQL nebo uloženou proceduru použitou k vložení nových záznamů do zdroje dat.

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

public System.Data.OleDb.OleDbCommand InsertCommand { get; set; }

member this.InsertCommand : System.Data.OleDb.OleDbCommand with get, set

Public Property InsertCommand As OleDbCommand

Hodnota vlastnosti

OleDbCommand

OleDbCommand Slouží Update(DataSet) k vložení záznamů do zdroje dat, které odpovídají novým řádkům v objektu DataSet.

Příklady

Následující příklad vytvoří OleDbDataAdapter a nastaví SelectCommand a InsertCommand vlastnosti. Předpokládá se, že jste již vytvořili OleDbConnection objekt.

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

Poznámky

Pokud Updatetato vlastnost není nastavena a informace o primárním klíči jsou přítomny v nástroji DataSet, InsertCommand lze vygenerovat automaticky, pokud nastavíte SelectCommand vlastnost a použijete OleDbCommandBuilder. Potom se vygenerují OleDbCommandBuildervšechny další příkazy, které nenastavíte . Tato logika generování vyžaduje, aby informace o klíčovém sloupci byly přítomny v objektu DataSet. Další informace naleznete v tématu Generování příkazů pomocí CommandBuilders.

Při InsertCommand přiřazení k dříve vytvořenému OleDbCommandsouboru OleDbCommand se nenaklonuje. Udržuje InsertCommand odkaz na dříve vytvořený OleDbCommand objekt.

Note

Pokud provádění tohoto příkazu vrátí řádky, mohou být tyto řádky přidány do DataSet závislosti na tom, jak nastavíte UpdatedRowSource vlastnost objektu OleDbCommand .

Viz také

• Datové adaptéry a čtečky dat