OleDbDataAdapter.InsertCommand Proprietà

Definizione

Spazio dei nomi:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Pacchetto:

System.Data.OleDb v9.0.0-rc.2.24473.5

Origine:

OleDbDataAdapter.cs

Ottiene o imposta un'istruzione SQL o una stored procedure usata per inserire nuovi record nell'origine dati.

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

Valore della proprietà

OleDbCommand

Oggetto OleDbCommand utilizzato durante l'applicazione del metodo Update(DataSet) per inserire record nell'origine dati che corrispondono alle nuove righe nell'oggetto DataSet.

Esempio

Nell'esempio seguente viene creato un oggetto OleDbDataAdapter e vengono impostate le SelectCommand proprietà e InsertCommand . Presuppone che sia già stato creato un OleDbConnection oggetto .

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

Commenti

Durante Update, se questa proprietà non è impostata e le informazioni sulla chiave primaria sono presenti in DataSet, l'oggetto InsertCommand può essere generato automaticamente se si imposta la SelectCommand proprietà e si usa .OleDbCommandBuilder Eventuali comandi aggiuntivi non impostati vengono quindi generati da OleDbCommandBuilder. Questa logica di generazione richiede che le informazioni sulla colonna chiave siano presenti in DataSet. Per altre informazioni, vedere Generazione dei comandi con CommandBuilders.

Quando InsertCommand viene assegnato a un oggetto creato OleDbCommandin precedenza, l'oggetto OleDbCommand non viene clonato. Mantiene InsertCommand un riferimento all'oggetto creato OleDbCommand in precedenza.

Nota

Se l'esecuzione di questo comando restituisce righe, è possibile aggiungere queste righe a DataSet a seconda della modalità di impostazione della UpdatedRowSource proprietà dell'oggetto OleDbCommand .

Vedi anche

• DataAdapter e DataReader