OracleDataAdapter.InsertCommand 属性

定义

命名空间:

System.Data.OracleClient

程序集:

System.Data.OracleClient.dll

获取或设置用于将新记录插入到数据库中的 SQL 语句或存储过程。

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

public System.Data.OracleClient.OracleCommand InsertCommand { get; set; }

member this.InsertCommand : System.Data.OracleClient.OracleCommand with get, set

Public Property InsertCommand As OracleCommand

属性值

OracleCommand

OracleCommand，在更新操作中使用，用于将与 DataSet 中的新行对应的记录插入数据库。

示例

以下示例创建 并 OracleDataAdapter 设置 SelectCommand 和 InsertCommand 属性。 它假定你已创建对象 OracleConnection 。

Public Shared Function CreateCustomerAdapter(conn As OracleConnection) As OracleDataAdapter   

  Dim da As OracleDataAdapter = New OracleDataAdapter()  
  Dim cmd As OracleCommand  

  ' Create the SelectCommand.  

  cmd = New OracleCommand("SELECT * FROM Dept " & _  
                       "WHERE DName = :pDName AND Loc = :pLoc", conn)  

  cmd.Parameters.Add("pDName", OracleType.NVarChar, 14)  
  cmd.Parameters.Add("pLoc", OracleType.NVarChar, 13)  

  da.SelectCommand = cmd  

  ' Create the InsertCommand.  

  cmd = New OracleCommand("INSERT INTO Dept (DeptNo, DName) " & _  
                       "VALUES (:pDeptNo, :pDName)", conn)  

  cmd.Parameters.Add("pDeptNo", OracleType.Number, 2, "DeptNo")  
  cmd.Parameters.Add("pDName", OracleType.NVarChar, 14, "DName")  

  da.InsertCommand = cmd  

  Return da  
End Function  

public static OracleDataAdapter CreateCustomerAdapter(OracleConnection conn)  
{  
  OracleDataAdapter da = new OracleDataAdapter();  
  OracleCommand cmd;  

  // Create the SelectCommand.  

  cmd = new OracleCommand("SELECT * FROM Dept " +  
                       "WHERE DName = :pDName AND Loc = :pLoc", conn);  

  cmd.Parameters.Add("pDName", OracleType.NVarChar, 14);  
  cmd.Parameters.Add("pLoc", OracleType.NVarChar, 13);  

  da.SelectCommand = cmd;  

  // Create the InsertCommand.  

  cmd = new OracleCommand("INSERT INTO Dept (DeptNo, DName) " +  
                       "VALUES (:pDeptNo, :pDName)", conn);  

  cmd.Parameters.Add("pDeptNo", OracleType.Number, 2, "DeptNo");  
  cmd.Parameters.Add("pDName", OracleType.NVarChar, 14, "DName");  

  da.InsertCommand = cmd;  

  return da;  
}  

注解

将 InsertCommand 属性分配给以前创建 OracleCommand 的对象时， OracleCommand 不会克隆 。 InsertCommand而是维护对以前创建的 OracleCommand的 的引用。

在更新操作期间，如果未 InsertCommand 设置 ，并且 中存在 DataSet主键信息，则可以使用 OracleCommandBuilder 类自动生成 InsertCommand，以及将 协调 DataSet 到数据库所需的其他命令。 为此，请设置 SelectCommand 的 OracleDataAdapter属性。 生成逻辑还要求键列信息存在于 中 DataSet。 有关详细信息，请参阅 使用 CommandBuilders 生成命令。

注意

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

使用 LONG RAW 数据类型更新列时，在列中输入 值 NULL 时会引发异常。 Oracle LONG RAW 数据类型是 Oracle 版本 8.0 中已弃用的类型。 若要避免此错误，请使用 BLOB 数据类型而不是 LONG RAW。

另请参阅

• 在 ADO.NET 中检索和修改数据