IDbDataAdapter.InsertCommand Свойство

Определение

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

System.Data

Сборки:

netstandard.dll, System.Data.Common.dll

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

IDbDataAdapter.cs

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

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

public System.Data.IDbCommand? InsertCommand { get; set; }

member this.InsertCommand : System.Data.IDbCommand with get, set

Public Property InsertCommand As IDbCommand

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

IDbCommand

Используется IDbCommand во время Update(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 свойство поставщика данных .NET Framework. Затем все дополнительные команды, которые не заданы, создаются CommandBuilder. Эта логика создания требует, чтобы в этой логике были представлены сведения о ключевых столбцах DataSet. Дополнительные сведения см. в разделе "Создание команд с помощью CommandBuilders".

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

Замечание

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