OleDbDataAdapter.InsertCommand Свойство

  • Ссылка

Определение

Пространство имен:
System.Data.OleDb
Сборка:
System.Data.OleDb.dll
Сборка:
System.Data.dll

Возвращает или задает инструкцию либо хранимую процедуру SQL, используемую для вставки записей в источнике данных.

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

Значение свойства

OleDbCommand

Команда OleDbCommand, используемая в ходе Update(DataSet) для добавления в источник данных записей, соответствующих новым строкам в наборе DataSet.

Атрибуты
DataSysDescriptionAttribute

Примеры

В следующем примере создается OleDbDataAdapter и задается и задаются SelectCommand свойства.InsertCommand Предполагается, что вы уже создали OleDbConnection объект.

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

Комментарии

Если Updateэто свойство не задано, а сведения о первичном ключе присутствуют в объекте DataSet, InsertCommand его можно создать автоматически, если задать SelectCommand свойство и использовать OleDbCommandBuilderего. Затем никакие дополнительные команды, которые не заданы, создаются с OleDbCommandBuilderпомощью . Эта логика создания требует, чтобы сведения о ключевом столбце присутствовали DataSetв . Дополнительные сведения см. в статье Создание команд с помощью классов CommandBuilder.

При InsertCommand назначении ранее созданному OleDbCommandOleDbCommand объекту не клонируется. Сохраняет InsertCommand ссылку на ранее созданный OleDbCommand объект.

Примечание

Если выполнение этой команды возвращает строки, эти строки могут быть добавлены в DataSet зависимости от того, как задать UpdatedRowSource свойство OleDbCommand объекта.

Применяется к

См. также раздел