OleDbDataAdapter.InsertCommand Свойство

Определение

Пространство имен:

System.Data.OleDb

Сборка:

System.Data.OleDb.dll

Пакет:

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

Исходный код:

OleDbDataAdapter.cs

Возвращает или задает инструкцию 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; }

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

Public Property InsertCommand As OleDbCommand

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

OleDbCommand

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

Примеры

В следующем примере создается 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 объекта.

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

• Объекты DataAdapter и DataReader