DbCommandBuilder 類別

定義

命名空間:

System.Data.Common

組件:

netstandard.dll, System.Data.Common.dll

來源:

DBCommandBuilder.cs

自動產生單表指令，用於對 A DataSet 的變更與相關資料庫進行調和。 這是一個只能繼承的抽象類別。

public ref class DbCommandBuilder abstract : System::ComponentModel::Component

public abstract class DbCommandBuilder : System.ComponentModel.Component

type DbCommandBuilder = class
    inherit Component

Public MustInherit Class DbCommandBuilder
Inherits Component

繼承

Object

MarshalByRefObject

Component

DbCommandBuilder

衍生

System.Data.Odbc.OdbcCommandBuilder

System.Data.OleDb.OleDbCommandBuilder

備註

此 DbCommandBuilder 課程是為了方便提供者撰寫者自行建立指令建構器而設。 透過繼承此類別，開發者可以在自己的程式碼中實作提供者特定的行為。

它 DbDataAdapter 不會自動產生 SQL 陳述式，以將對 a DataSet 的變更與相關資料來源進行調和。 不過，如果你設定 SelectCommand . 的屬性DbDataAdapter，你可以建立DbCommandBuilder一個物件，自動產生用於單表更新的 SQL 語句。 然後，任何你未設定的額外 SQL 語句會由 DbCommandBuilder產生。

當你設定DataAdapter屬性時，它DbCommandBuilder會自動註冊為事件的監聽者RowUpdating。 你一次只能將其中一個 DbDataAdapter 或 DbCommandBuilder 物件彼此關聯起來。

為了產生 INSERT、UPDATE 或 DELETE 語句，會 DbCommandBuilder 使用 該 SelectCommand 屬性自動取得所需的元資料集合。 如果你在元資料取得後（例如第一次更新後）更改 ， SelectCommand 你應該呼叫 RefreshSchema 更新元資料的方法。

SelectCommand 還必須傳回至少一個主索引鍵或唯一的資料行。 若不存在 InvalidOperationException ，則會產生例外，指令不會被產生。

也 DbCommandBuilder 使用 Connection了 、 CommandTimeout以及 Transaction 所 SelectCommand參考的屬性。 使用者應在這些屬性中的任何一項被修改，或SelectCommand是該屬性本身被替換時呼叫RefreshSchema。 否則 InsertCommand、 UpdateCommand、 和 DeleteCommand 屬性將保留先前的值。

如果你呼叫 Dispose，則 DbCommandBuilder 與 分離 DbDataAdapter，產生的指令不再使用。

建構函式

名稱	Description
DbCommandBuilder()	初始化一個繼承自該 DbCommandBuilder 類別的新實例。

屬性

名稱	Description
CanRaiseEvents	會得到一個值，表示該元件是否能引發事件。 (繼承來源 Component)
CatalogLocation	取得或設定 CatalogLocation 該類別的實例 DbCommandBuilder 。
CatalogSeparator	取得或設定一個字串，作為類別實例 DbCommandBuilder 的目錄分隔符。
ConflictOption	指定 ConflictOption 要被 使用的 DbCommandBuilder。
Container	得到 IContainer 包含 Component的 。 (繼承來源 Component)
DataAdapter	取得或設定一個 DbDataAdapter 物件，該物件會自動產生 Transact-SQL 語句。
DesignMode	會得到一個值，表示目前 Component 是否處於設計模式。 (繼承來源 Component)
Events	會取得與此 Component連結的事件處理程序清單。 (繼承來源 Component)
QuotePrefix	取得或設定在指定資料庫物件（例如資料表或欄位）時，名稱包含空格或保留標記等字元的開頭字元。
QuoteSuffix	在指定資料庫物件（例如資料表或欄位）時，取得或設定包含空格或保留標記等字元的結尾字元。
SchemaSeparator	取得或設定用於結構識別碼與其他識別碼分隔符的字元。
SetAllValues	指定更新語句中所有欄位值是否包含，或僅包含變更欄位。
Site	取得或設定 ISite 的 Component。 (繼承來源 Component)

方法

名稱	Description
ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean)	允許類別的提供者實作 DbCommandBuilder 處理額外的參數屬性。
Dispose()	釋放所有由 Component. (繼承來源 Component)
Dispose(Boolean)	釋放 未管理的資源， DbCommandBuilder 並可選擇性地釋放受管理資源。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetDeleteCommand()	取得自動產生 DbCommand 的物件，用於在資料來源執行刪除。
GetDeleteCommand(Boolean)	取得自動產生 DbCommand 的物件，用於在資料來源執行刪除，並可選擇使用欄位作為參數名稱。
GetHashCode()	做為預設哈希函式。 (繼承來源 Object)
GetInsertCommand()	取得自動產生 DbCommand 的物件，用於在資料來源執行插入。
GetInsertCommand(Boolean)	取得自動產生 DbCommand 的物件，用於在資料來源執行插入，並可選擇使用欄位作為參數名稱。
GetLifetimeService()	已淘汰. 取得目前控制此實例生命週期政策的終身服務物件。 (繼承來源 MarshalByRefObject)
GetParameterName(Int32)	以 格式 @p#回傳指定參數名稱。 用來打造自訂指令建構器。
GetParameterName(String)	回傳完整的參數名稱，給定部分參數名稱。
GetParameterPlaceholder(Int32)	回傳相關 SQL 陳述式中參數的佔位符。
GetSchemaTable(DbCommand)	回傳 的結構表 DbCommandBuilder。
GetService(Type)	回傳一個由 或Component其 所提供的Container服務的物件。 (繼承來源 Component)
GetType()	取得目前實例的 Type。 (繼承來源 Object)
GetUpdateCommand()	取得自動產生 DbCommand 的物件，以便在資料來源執行更新。
GetUpdateCommand(Boolean)	取得自動產生 DbCommand 的物件，用於在資料來源執行更新，並可選擇使用欄位作為參數名稱。
InitializeCommand(DbCommand)	重置 CommandTimeout、 Transaction、 CommandType及 UpdateRowSource 屬性。DbCommand
InitializeLifetimeService()	已淘汰. 取得一個終身服務物件以控制此實例的終身政策。 (繼承來源 MarshalByRefObject)
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
MemberwiseClone(Boolean)	建立一個 MarshalByRefObject 目前物件的淺層複製品。 (繼承來源 MarshalByRefObject)
QuoteIdentifier(String)	給定一個位於正確目錄案例中的未引號識別碼，會回傳該識別碼的正確引號形式，包括正確地避開該識別碼中嵌入的引號。
RefreshSchema()	清除與此 DbCommandBuilder相關指令。
RowUpdatingHandler(RowUpdatingEventArgs)	新增事件處理程式。RowUpdating
SetRowUpdatingHandler(DbDataAdapter)	註冊 以DbCommandBuilder處理RowUpdating事件。DbDataAdapter
ToString()	回傳 String 包含 的名稱 Component（若有的話）。 此方法不應被覆蓋。 (繼承來源 Component)
UnquoteIdentifier(String)	給定引號識別碼時，回傳該識別碼的正確未引號形式，包括正確解脫標識中嵌入的引號。

事件

名稱	Description
Disposed	當元件被呼叫方法 Dispose() 時會發生。 (繼承來源 Component)

另請參閱

• 使用 CommandBuilders 產生命令
• ADO.NET 概觀