IDbDataAdapter.InsertCommand 属性

项目
08/17/2007

获取或设置用于将新记录插入到数据源中的 SQL 语句。

**命名空间:**System.Data
**程序集:**System.Data（在 system.data.dll 中）

语法

声明
Property InsertCommand As IDbCommand
用法
Dim instance As IDbDataAdapter
Dim value As IDbCommand

value = instance.InsertCommand

instance.InsertCommand = value

IDbCommand InsertCommand { get; set; }

property IDbCommand^ InsertCommand {
    IDbCommand^ get ();
    void set (IDbCommand^ value);
}

/** @property */
IDbCommand get_InsertCommand ()

/** @property */
void set_InsertCommand (IDbCommand value)

function get InsertCommand () : IDbCommand

function set InsertCommand (value : IDbCommand)

属性值

在 Update 过程中使用的 IDbCommand，它针对数据集中的新行将记录插入到数据源。

备注

在 Update 过程中，如果未设置此属性，且 DataSet 中存在主键信息，那么当设置 .NET Framework 数据提供程序的 SelectCommand 属性时，可以自动生成 InsertCommand。然后，未设置的任何其他命令都由 CommandBuilder 生成。此生成逻辑要求 DataSet 中存在键列信息。有关更多信息，请参见自动生成命令。

在将 InsertCommand 分配给以前创建的 IDbCommand 时，不克隆 IDbCommand。InsertCommand 维护对以前创建的 IDbCommand 对象的引用。

提示

如果执行此命令后返回行，这些行可能会添加到 DataSet 中，具体取决于如何设置 IDbCommand 对象的 UpdatedRowSource 属性。

示例

下面的示例创建继承的 OleDbDataAdapter 类的实例，并设置 SelectCommand 和 InsertCommand 属性。假定已经创建了一个 OleDbConnection 对象。

Public Shared Function CreateCustomerAdapter( _
    connection As OleDbConnection) As OleDbDataAdapter 
  
    Dim adapter As OleDbDataAdapter = 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

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

平台

Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

通过

IDbDataAdapter.InsertCommand 属性

语法

属性值

备注

示例

平台

版本信息

.NET Framework

.NET Compact Framework

请参见

参考

其他资源