OracleCommandBuilder 类

定义

命名空间:

System.Data.OracleClient

程序集:

System.Data.OracleClient.dll

注意

OracleCommandBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260

自动生成用于协调 DataSet 的更改与关联数据库的单表命令。 此类不能被继承。

public ref class OracleCommandBuilder sealed : System::Data::Common::DbCommandBuilder

[System.Obsolete("OracleCommandBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)]
public sealed class OracleCommandBuilder : System.Data.Common.DbCommandBuilder

[<System.Obsolete("OracleCommandBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)>]
type OracleCommandBuilder = class
    inherit DbCommandBuilder

Public NotInheritable Class OracleCommandBuilder
Inherits DbCommandBuilder

继承

Object

MarshalByRefObject

Component

DbCommandBuilder

OracleCommandBuilder

属性

ObsoleteAttribute

示例

以下示例使用 OracleCommand以及 OracleDataAdapter 和 OracleConnection从数据库中选择行。 该示例传递了初始化DataSet的 、连接字符串、SQL SELECT 语句的查询字符串，以及作为数据库表名称的字符串。 然后，该示例创建一个 OracleCommandBuilder。

Private Function SelectOracleRows(connection As String, queryString As String, tableName As String) As DataSet  

   Dim connection As New OracleConnection(connection)  
   Dim dataAdapter As New OracleDataAdapter()  
   Dim dataSet As DataSet = New DataSet  

   dataAdapter.SelectCommand = New OracleCommand(queryString, connection)  

   Dim cmdBuilder As OracleCommandBuilder = New OracleCommandBuilder(dataAdapter)  

   connection.Open()  
   dataAdapter.Fill(dataSet, tableName)  
      ' Code to modify data in DataSet here   
      ' Without the OracleCommandBuilder this line would fail.  
   dataAdapter.Update(dataSet, tableName)  
   connection.Close()  
End Function  

public static DataSet SelectOracleSrvRows(string myConnection, string mySelectQuery, string myTableName)  
{  
   OracleConnection myConn = new OracleConnection(myConnection);  
   OracleDataAdapter myDataAdapter = new OracleDataAdapter();  
   myDataAdapter.SelectCommand = new OracleCommand(mySelectQuery, myConn);  
   OracleCommandBuilder cb = new OracleCommandBuilder(myDataAdapter);  

   myConn.Open();  
   DataSet ds = new DataSet();  
   myDataAdapter.Fill(ds, myTableName);  

   //Code to modify data in DataSet goes here...  

   //Without the OracleCommandBuilder this line would fail.  
   myDataAdapter.Update(ds, myTableName);  
   myConn.Close();  
   return ds;  
}  

注解

此类型已弃用，并将在.NET Framework的未来版本中删除。 有关详细信息，请参阅 Oracle 和 ADO.NET。

OracleDataAdapter不会自动生成协调对与数据库关联的 所做的更改DataSet所需的 SQL 语句。 但是，可以通过设置 SelectCommand 的 OracleDataAdapter属性创建一个OracleCommandBuilder对象，该对象为单表更新生成 SQL 语句。 然后， OracleCommandBuilder 生成未设置的任何其他 SQL 语句。

与其对应OracleCommandBuilder项之间的关系OracleDataAdapter始终是一对一的。 若要创建此对应关系，请设置 OracleDataAdapter 对象的 属性 OracleCommandBuilder 。 这会导致 OracleCommandBuilder 将自身注册为侦听器，从而生成影响 的事件的RowUpdatingDataSet输出。

若要生成 INSERT、UPDATE 或 DELETE 语句， OracleCommandBuilder 使用 SelectCommand 属性检索所需的元数据集。

OracleCommandBuilder还使用 Connection引用的 SelectCommand、 和 Transaction 属性。

如果调用 Dispose， OracleCommandBuilder 则会取消与 OracleDataAdapter的关联，并且不再使用生成的命令。

构造函数

OracleCommandBuilder()	已过时. 初始化 OracleCommandBuilder 的新实例。
OracleCommandBuilder(OracleDataAdapter)	已过时. 使用关联的 OracleCommandBuilder 对象初始化 OracleDataAdapter 类的新实例。

属性

CanRaiseEvents	已过时. 获取一个指示组件是否可以引发事件的值。 (继承自 Component)
CatalogLocation	已过时. 获取或设置 DbCommandBuilder 类的实例的 CatalogLocation。
CatalogSeparator	已过时. 获取或设置一个字符串，该字符串用作 DbCommandBuilder 类的实例的目录分隔符。
ConflictOption	已过时. 指定哪个 ConflictOption 将由 DbCommandBuilder 使用。 (继承自 DbCommandBuilder)
Container	已过时. 获取包含 IContainer 的 Component。 (继承自 Component)
DataAdapter	已过时. 获取或设置此 OracleDataAdapter 对象将为其生成 SQL 语句的 OracleCommandBuilder 对象。
DesignMode	已过时. 获取一个值，用以指示 Component 当前是否处于设计模式。 (继承自 Component)
Events	已过时. 获取附加到此 Component 的事件处理程序的列表。 (继承自 Component)
QuotePrefix	已过时. 获取或设置指定其名称包含空格或保留标记等字符的数据库对象（例如，表或列）时使用的开始字符。 (继承自 DbCommandBuilder)
QuoteSuffix	已过时. 获取或设置一个或多个结束字符，供指定其名称中包含空格或保留标记等字符的数据库对象（例如，表或列）时使用。 (继承自 DbCommandBuilder)
SchemaSeparator	已过时. 获取或设置要用作架构标识符和任何其他标识符之间的分隔符的字符。
SetAllValues	已过时. 指定 update 语句中是包含所有列值还是仅包含更改的列值。 (继承自 DbCommandBuilder)
Site	已过时. 获取或设置 Component 的 ISite。 (继承自 Component)

方法

ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean)	已过时. 允许 DbCommandBuilder 类的提供程序实现处理附加参数属性。 (继承自 DbCommandBuilder)
CreateObjRef(Type)	已过时. 创建一个对象，该对象包含生成用于与远程对象进行通信的代理所需的全部相关信息。 (继承自 MarshalByRefObject)
DeriveParameters(OracleCommand)	已过时. 从在 OracleCommand 中指定的存储过程中检索参数信息并填充指定的 Parameters 对象的 OracleCommand 集合。
Dispose()	已过时. 释放由 Component 使用的所有资源。 (继承自 Component)
Dispose(Boolean)	已过时. 释放由 DbCommandBuilder 占用的非托管资源，还可以另外再释放托管资源。 (继承自 DbCommandBuilder)
Equals(Object)	已过时. 确定指定对象是否等于当前对象。 (继承自 Object)
GetDeleteCommand()	已过时. 获取自动生成的、对数据库执行删除操作所需的 OracleCommand 对象。
GetDeleteCommand(Boolean)	已过时. 获取自动生成的、对数据库执行删除操作所需的 OracleCommand 对象。
GetHashCode()	已过时. 作为默认哈希函数。 (继承自 Object)
GetInsertCommand()	已过时. 获取自动生成的、对数据库执行插入操作所需的 OracleCommand 对象。
GetInsertCommand(Boolean)	已过时. 获取自动生成的、对数据库执行插入操作所需的 OracleCommand 对象。
GetLifetimeService()	检索控制此实例的生存期策略的当前生存期服务对象。 (继承自 MarshalByRefObject)
GetParameterName(Int32)	已过时. 以 格式 @p#返回指定参数的名称。 在生成自定义命令生成器时使用。 (继承自 DbCommandBuilder)
GetParameterName(String)	已过时. 给定部分参数名，返回完整参数名。 (继承自 DbCommandBuilder)
GetParameterPlaceholder(Int32)	已过时. 返回该参数在关联的 SQL 语句中的占位符。 (继承自 DbCommandBuilder)
GetSchemaTable(DbCommand)	已过时. 返回 DbCommandBuilder 的架构表。 (继承自 DbCommandBuilder)
GetService(Type)	已过时. 返回一个对象，该对象表示由 Component 或它的 Container 提供的服务。 (继承自 Component)
GetType()	已过时. 获取当前实例的 Type。 (继承自 Object)
GetUpdateCommand()	已过时. 获取自动生成的、对数据库执行更新操作所需的 OracleCommand 对象。
GetUpdateCommand(Boolean)	已过时. 获取自动生成的、对数据库执行更新操作所需的 OracleCommand 对象。
InitializeCommand(DbCommand)	已过时. 重置 CommandTimeout 上的 Transaction、CommandType、UpdateRowSource 和 DbCommand 属性。 (继承自 DbCommandBuilder)
InitializeLifetimeService()	获取生存期服务对象来控制此实例的生存期策略。 (继承自 MarshalByRefObject)
MemberwiseClone()	已过时. 创建当前 Object 的浅表副本。 (继承自 Object)
MemberwiseClone(Boolean)	已过时. 创建当前 MarshalByRefObject 对象的浅表副本。 (继承自 MarshalByRefObject)
QuoteIdentifier(String)	已过时. 以正确的目录大小写给定一个不带引号的标识符，返回该标识符的带引号的正确形式，包括正确转义该标识符中嵌入的任何引号。
RefreshSchema()	已过时. 清除与此 DbCommandBuilder 关联的命令。 (继承自 DbCommandBuilder)
RowUpdatingHandler(RowUpdatingEventArgs)	已过时. 添加 RowUpdating 事件的事件处理程序。 (继承自 DbCommandBuilder)
SetRowUpdatingHandler(DbDataAdapter)	已过时. 注册 DbCommandBuilder 以处理 RowUpdating 的 DbDataAdapter 事件。 (继承自 DbCommandBuilder)
ToString()	已过时. 返回包含 Component 的名称的 String（如果有）。 不应重写此方法。 (继承自 Component)
UnquoteIdentifier(String)	已过时. 给定一个带引号的标识符，返回该标识符的不带引号的正确形式，包括正确地取消转义该标识符中嵌入的任何引号。

事件

Disposed

已过时. 在通过调用 Dispose() 方法释放组件时发生。 (继承自 Component)

另请参阅

• 使用 CommandBuilder 生成命令