OleDbDataAdapter.InsertCommand Vlastnost

Definice

Obor názvů:

System.Data.OleDb

Sestavení:

System.Data.OleDb.dll

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; }

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

[System.Data.DataSysDescription("DbDataAdapter_InsertCommand")]
public System.Data.OleDb.OleDbCommand InsertCommand { get; set; }

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

[<System.Data.DataSysDescription("DbDataAdapter_InsertCommand")>]
member this.InsertCommand : System.Data.OleDb.OleDbCommand with get, set

Public Property InsertCommand As OleDbCommand

Hodnota vlastnosti

OleDbCommand

Použitý OleDbCommand při Update(DataSet) vkládání záznamů do zdroje dat, který odpovídá novým řádkům v sadě DataSet.

Atributy

DataSysDescriptionAttribute

Příklady

Následující příklad vytvoří OleDbDataAdapter a nastaví SelectCommand a InsertCommand vlastnosti. Předpokládá se, že jste už 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

Během Update, pokud tato vlastnost není nastavena a primární klíč informace jsou přítomny v DataSet, InsertCommand lze vygenerovat automaticky, pokud nastavíte SelectCommand vlastnost a použijete OleDbCommandBuilder. Potom všechny další příkazy, které nenastavíte, se vygenerují OleDbCommandBuilderpomocí příkazu . Tato logika generování vyžaduje, aby informace o klíčových sloupcích byly přítomny v souboru 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.

Poznámka

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é

• Adaptéry a čtečky dat