DbCommandBuilder クラス

定義

名前空間:

System.Data.Common

アセンブリ:

System.Data.Common.dll

ソース:

DBCommandBuilder.cs

データベースに関連付けられた 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

System.Data.SqlClient.SqlCommandBuilder

注釈

クラスは DbCommandBuilder 、プロバイダー ライターが独自のコマンド ビルダーを作成する際に便利な目的で提供されます。 このクラスから継承することで、開発者はプロバイダー固有の動作を独自のコードに実装できます。

では DbDataAdapter 、 に対して行われた DataSet 変更を関連付けられたデータ ソースと調整するために必要な SQL ステートメントは自動的に生成されません。 ただし、 の プロパティをDbCommandBuilder設定すると、単一テーブル更新用の SQL ステートメントを自動的に生成する オブジェクトをSelectCommandDbDataAdapter作成できます。 その後、設定しない追加の SQL ステートメントは、 によって DbCommandBuilder生成されます。

はDbCommandBuilder、 プロパティを設定するたびに、それ自体をイベントのRowUpdatingDataAdapterリスナーとして登録します。 一度に関連付けることができるのは、1 つまたはDbDataAdapterDbCommandBuilder複数のオブジェクトのみです。

INSERT、UPDATE、または DELETE ステートメントを生成するには、 DbCommandBuilder プロパティを SelectCommand 使用して、必要なメタデータのセットを自動的に取得します。 メタデータが取得された後 (たとえば、最初の更新後) を変更 SelectCommand する場合は、 メソッドを RefreshSchema 呼び出してメタデータを更新する必要があります。

SelectCommand は少なくとも 1 つの主キーまたは一意の列を返す必要があります。 存在しない場合は例外 InvalidOperationException が生成され、コマンドは生成されません。

DbCommandBuilderでは、 によって参照される 、CommandTimeout、および Transaction プロパティも使用ConnectionされますSelectCommand。 これらのプロパティのいずれかが変更された場合、またはそれ自体が置き換えられた場合、ユーザーは をSelectCommand呼び出すRefreshSchema必要があります。 それ以外の場合、 InsertCommand、 UpdateCommand、および DeleteCommand の各プロパティは、以前の値を保持します。

を呼び出 Disposeすと、 DbCommandBuilder は から DbDataAdapter関連付け解除され、生成されたコマンドは使用されなくなります。

コンストラクター

DbCommandBuilder()

DbCommandBuilder クラスから継承するクラスの新しいインスタンスを初期化します。

プロパティ

CanRaiseEvents	コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。 (継承元 Component)
CatalogLocation	DbCommandBuilder クラスのインスタンスの CatalogLocation を取得または設定します。
CatalogSeparator	DbCommandBuilder クラスのインスタンスのカタログの区切り記号として使用する文字列を取得または設定します。
ConflictOption	ConflictOption で使用する DbCommandBuilder を指定します。
Container	IContainer を含む Component を取得します。 (継承元 Component)
DataAdapter	Transact-SQL ステートメントを自動生成する対象の DbDataAdapter オブジェクトを取得または設定します。
DesignMode	Component が現在デザイン モードかどうかを示す値を取得します。 (継承元 Component)
Events	Component に結び付けられているイベント ハンドラーのリストを取得します。 (継承元 Component)
QuotePrefix	名前に空白や予約済みトークンなどの文字を含むデータベース オブジェクト (テーブル、列など) を指定するための開始文字を取得または設定します。
QuoteSuffix	名前に空白や予約済みトークンなどの文字を含むデータベース オブジェクト (テーブル、列など) を指定するための終了文字を取得または設定します。
SchemaSeparator	スキーマ識別子と他の識別子との間の区切り記号として使用される文字列を取得または設定します。
SetAllValues	UPDATE ステートメントにすべての列値が含まれるのか、変更になった列値だけが含まれるのかを示します。
Site	Component の ISite を取得または設定します。 (継承元 Component)

メソッド

ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean)	DbCommandBuilder クラスのプロバイダーの実装が、追加パラメーターのプロパティを処理できるようにします。
CreateObjRef(Type)	リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (継承元 MarshalByRefObject)
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)	大文字と小文字を正しく区別したカタログ内の、引用符で囲まれていない ID が指定されると、その ID を引用符で囲まれた正しい形式で返します。ID 内に埋め込まれている引用符はすべて適切にエスケープされます。
RefreshSchema()	この DbCommandBuilder に関連付けられているコマンドを削除します。
RowUpdatingHandler(RowUpdatingEventArgs)	RowUpdating イベントのイベント ハンドラーを追加します。
SetRowUpdatingHandler(DbDataAdapter)	DbCommandBuilder を登録して、RowUpdating の DbDataAdapter イベントを処理します。
ToString()	Component の名前 (存在する場合) を格納する String を返します。 このメソッドはオーバーライドできません。 (継承元 Component)
UnquoteIdentifier(String)	引用符で囲まれた ID が指定されると、その ID を引用符で囲まれない正しい形式で返します。ID 内に埋め込まれている引用符はすべて適切にエスケープ解除されます。

イベント

Disposed

Dispose() メソッドの呼び出しによってコンポーネントが破棄されるときに発生します。 (継承元 Component)

こちらもご覧ください

• CommandBuilder でのコマンドの生成
• ADO.NET の概要