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和 OracleDataAdapterOracleConnection，從資料庫選取數據列。 此範例會傳遞初始化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 的屬性，建立對象來產生單一OracleCommandBuilder數據表更新的 OracleDataAdapterSQL 語句。 然後， OracleCommandBuilder 會產生您未設定的任何其他 SQL 語句。

與其對應的OracleCommandBuilder關聯OracleDataAdapter性一律為一對一。 若要建立此對應，您可以設定 OracleDataAdapter 對象的屬性 OracleCommandBuilder 。 這會導致 OracleCommandBuilder 將本身註冊為接聽程式，這會產生影響 DataSet的事件輸出RowUpdating。

若要產生 INSERT、UPDATE 或 DELETE 語句，會 OracleCommandBuilder 使用 SelectCommand 屬性來擷取必要的元數據集。

OracleCommandBuilder也會使用 所參考的ConnectionSelectCommand、 和 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 物件，這個 OracleCommandBuilder 物件將會為它產生 SQL 陳述式。
DesignMode	已淘汰. 取得值，指出 Component 目前是否處於設計模式。 (繼承來源 Component)
Events	已淘汰. 取得附加在這個 Component 上的事件處理常式清單。 (繼承來源 Component)
QuotePrefix	已淘汰. 取得或設定開始字元 (一個或多個)，當指定其名稱包含空白或保留語彙基元 (Token) 之類字元的資料庫物件時，就可以使用。 (繼承來源 DbCommandBuilder)
QuoteSuffix	已淘汰. 取得或設定結束字元 (一個或多個)，當指定其名稱包含空白或保留語彙基元之類字元的資料庫物件時，就可以使用。 (繼承來源 DbCommandBuilder)
SchemaSeparator	已淘汰. 取得或設定用於結構描述識別項和任何其他識別項間之分隔符號的字元。
SetAllValues	已淘汰. 指定更新陳述式中包含所有資料行值或只包含已變更的資料行值。 (繼承來源 DbCommandBuilder)
Site	已淘汰. 取得或設定 Component 的 ISite。 (繼承來源 Component)

方法

ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean)	已淘汰. 允許 DbCommandBuilder 類別的提供者實作處理其他參數屬性。 (繼承來源 DbCommandBuilder)
CreateObjRef(Type)	已淘汰. 建立包含所有相關資訊的物件，這些資訊是產生用來與遠端物件通訊的所需 Proxy。 (繼承來源 MarshalByRefObject)
DeriveParameters(OracleCommand)	已淘汰. 從 OracleCommand 中指定的預存程序 (Stored Procedure) 擷取參數資訊，並填入 (Populate) 指定 Parameters 物件的 OracleCommand 集合。
Dispose()	已淘汰. 釋放 Component 所使用的所有資源。 (繼承來源 Component)
Dispose(Boolean)	已淘汰. 釋放 DbCommandBuilder 所使用的 Unmanaged 資源，並選擇性地釋放 Managed 資源。 (繼承來源 DbCommandBuilder)
Equals(Object)	已淘汰. 判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetDeleteCommand()	已淘汰. 取得在資料庫上執行刪除時所需之自動產生的 OracleCommand 物件。
GetDeleteCommand(Boolean)	已淘汰. 取得在資料庫上執行刪除時所需之自動產生的 OracleCommand 物件。
GetHashCode()	已淘汰. 做為預設雜湊函式。 (繼承來源 Object)
GetInsertCommand()	已淘汰. 取得在資料庫上執行插入時所需之自動產生的 OracleCommand 物件。
GetInsertCommand(Boolean)	已淘汰. 取得在資料庫上執行插入時所需之自動產生的 OracleCommand 物件。
GetLifetimeService()	擷取控制這個執行個體存留期 (Lifetime) 原則的目前存留期服務物件。 (繼承來源 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 產生命令