DbCommandBuilderとは? わかりやすく解説

DbCommandBuilder イベント


DbCommandBuilder クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

データベースに関連付けられた DataSet への変更を調整するための単一テーブル コマンドを自動的に生成します。これは抽象クラスであり、継承以外はできません。

名前空間: System.Data.Common
アセンブリ: System.Data (system.data.dll 内)
構文構文

Public MustInherit Class
 DbCommandBuilder
    Inherits Component
Dim instance As DbCommandBuilder
public abstract class DbCommandBuilder : Component
public abstract class DbCommandBuilder extends
 Component
public abstract class DbCommandBuilder extends
 Component
解説解説

DbCommandBuilder クラスは、プロバイダの作成者が独自のコマンド ビルダを作成するときに役立つように用意されています。このクラスから継承することで、開発者は独自のコードにプロバイダ固有の動作を実装できます。

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

DataAdapter プロパティを設定すると、DbCommandBuilder が RowUpdating イベントのリスナとして自動的に登録されます。相互に関連付けることのできる DbDataAdapter オブジェクトと DbCommandBuilder オブジェクトは、それぞれ一度に 1 つだけです。

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

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

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

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

継承階層継承階層
System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
      System.Data.Common.DbCommandBuilder
         System.Data.Odbc.OdbcCommandBuilder
         System.Data.OleDb.OleDbCommandBuilder
         System.Data.OracleClient.OracleCommandBuilder
         System.Data.SqlClient.SqlCommandBuilder
         System.Data.SqlServerCe.SqlCeCommandBuilder
スレッド セーフスレッド セーフ
この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

DbCommandBuilder コンストラクタ


DbCommandBuilder プロパティ


DbCommandBuilder メソッド


パブリック メソッドパブリック メソッド

( プロテクト メソッド も参照)
  名前 説明
パブリック メソッド CreateObjRef  リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 ( MarshalByRefObject から継承されます。)
パブリック メソッド Dispose オーバーロードされます。 DbCommandBuilder によって使用されているリソースを解放します。
パブリック メソッド Equals  オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
パブリック メソッド GetDeleteCommand オーバーロードされます。 データ ソースで削除処理を実行するための、自動生成された DbCommand オブジェクトを取得します。
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
パブリック メソッド GetInsertCommand オーバーロードされます。 データ ソースで挿入処理を実行するための、自動生成された DbCommand オブジェクトを取得します。
パブリック メソッド GetLifetimeService  対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
パブリック メソッド GetType  現在のインスタンスの Type を取得します。 ( Object から継承されます。)
パブリック メソッド GetUpdateCommand オーバーロードされます。 データ ソースで更新処理を実行するための、自動生成された DbCommand オブジェクトを取得します。
パブリック メソッド InitializeLifetimeService  対象のインスタンスの有効期間ポリシーを制御する、有効期間サービス オブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
パブリック メソッド QuoteIdentifier 大文字と小文字を正しく区別したカタログ内の、引用符で囲まれていない ID が指定されると、その ID を引用符で囲まれた正しい形式で返します。ID 内に埋め込まれている引用符はすべて適切にエスケープされます。
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
パブリック メソッド RefreshSchema この DbCommandBuilder に関連付けられているコマンドを削除します。
パブリック メソッド ToString  Component の名前を格納している String を返します (存在する場合)。このメソッドはオーバーライドできません。 ( Component から継承されます。)
パブリック メソッド UnquoteIdentifier 引用符で囲まれた ID が指定されると、その ID を引用符で囲まれない正しい形式で返します。ID 内に埋め込まれている引用符はすべて適切にエスケープ解除されます。
プロテクト メソッドプロテクト メソッド
  名前 説明
プロテクト メソッド ApplyParameterInfo DbCommandBuilder クラスのプロバイダの実装が、追加パラメータのプロパティを処理できるようにします。
プロテクト メソッド Dispose オーバーロードされます。 オーバーライドされます。 DbCommandBuilder によって使用されているリソースを解放します。
プロテクト メソッド Finalize  Component がガベージ コレクションによってクリアされる前に、アンマネージ リソースを解放し、その他のクリーンアップ操作を実行します。 ( Component から継承されます。)
プロテクト メソッド GetParameterName オーバーロードされます。 指定したパラメータの名前を返します。
プロテクト メソッド GetParameterPlaceholder 関連付けられた SQL ステートメントのパラメータのプレースホルダを返します。
プロテクト メソッド GetSchemaTable DbCommandBuilder に対するスキーマ テーブルを返します。
プロテクト メソッド GetService  Component またはその Container で提供されるサービスを表すオブジェクトを返します。 ( Component から継承されます。)
プロテクト メソッド InitializeCommand DbCommand の CommandTimeout、Transaction、CommandType、および UpdateRowSource の各プロパティをリセットします。
プロテクト メソッド MemberwiseClone  オーバーロードされます。 ( MarshalByRefObject から継承されます。)
プロテクト メソッド RowUpdatingHandler RowUpdating イベントのイベント ハンドラを追加します。
プロテクト メソッド SetRowUpdatingHandler DbCommandBuilder を登録して、DbDataAdapter の RowUpdating イベントを処理します。
参照参照

関連項目

DbCommandBuilder クラス
System.Data.Common 名前空間

その他の技術情報

コマンドの自動生成

DbCommandBuilder メンバ

データベースに関連付けられた DataSet への変更を調整するための単一テーブル コマンドを自動的に生成します。これは抽象クラスであり、継承以外はできません。

DbCommandBuilder データ型で公開されるメンバを以下の表に示します。


プロテクト コンストラクタプロテクト コンストラクタ
  名前 説明
プロテクト メソッド DbCommandBuilder DbCommandBuilder クラスから継承するクラスの新しいインスタンスを初期化します。
パブリック プロパティパブリック プロパティ
プロテクト プロパティプロテクト プロパティ
パブリック メソッドパブリック メソッド
( プロテクト メソッド も参照)
  名前 説明
パブリック メソッド CreateObjRef  リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (MarshalByRefObject から継承されます。)
パブリック メソッド Dispose オーバーロードされます。 DbCommandBuilder によって使用されているリソースを解放します。
パブリック メソッド Equals  オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
パブリック メソッド GetDeleteCommand オーバーロードされます。 データ ソースで削除処理を実行するための、自動生成された DbCommand オブジェクトを取得します。
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
パブリック メソッド GetInsertCommand オーバーロードされます。 データ ソースで挿入処理を実行するための、自動生成された DbCommand オブジェクトを取得します。
パブリック メソッド GetLifetimeService  対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 (MarshalByRefObject から継承されます。)
パブリック メソッド GetType  現在のインスタンスの Type を取得します。 (Object から継承されます。)
パブリック メソッド GetUpdateCommand オーバーロードされます。 データ ソースで更新処理を実行するための、自動生成された DbCommand オブジェクトを取得します。
パブリック メソッド InitializeLifetimeService  対象のインスタンスの有効期間ポリシーを制御する、有効期間サービス オブジェクトを取得します。 (MarshalByRefObject から継承されます。)
パブリック メソッド QuoteIdentifier 大文字と小文字を正しく区別したカタログ内の、引用符で囲まれていない ID が指定されると、その ID を引用符で囲まれた正しい形式で返します。ID 内に埋め込まれている引用符はすべて適切にエスケープされます。
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
パブリック メソッド RefreshSchema この DbCommandBuilder に関連付けられているコマンドを削除します。
パブリック メソッド ToString  Component の名前を格納している String を返します (存在する場合)。このメソッドはオーバーライドできません。 (Component から継承されます。)
パブリック メソッド UnquoteIdentifier 引用符で囲まれた ID が指定されると、その ID を引用符で囲まれない正しい形式で返します。ID 内に埋め込まれている引用符はすべて適切にエスケープ解除されます。
プロテクト メソッドプロテクト メソッド
  名前 説明
プロテクト メソッド ApplyParameterInfo DbCommandBuilder クラスのプロバイダの実装が、追加パラメータのプロパティを処理できるようにします。
プロテクト メソッド Dispose オーバーロードされます。 オーバーライドされます。 DbCommandBuilder によって使用されているリソースを解放します。
プロテクト メソッド Finalize  Component がガベージ コレクションによってクリアされる前に、アンマネージ リソースを解放し、その他のクリーンアップ操作を実行します。 (Component から継承されます。)
プロテクト メソッド GetParameterName オーバーロードされます。 指定したパラメータの名前を返します。
プロテクト メソッド GetParameterPlaceholder 関連付けられた SQL ステートメントのパラメータのプレースホルダを返します。
プロテクト メソッド GetSchemaTable DbCommandBuilder に対するスキーマ テーブルを返します。
プロテクト メソッド GetService  Component またはその Container で提供されるサービスを表すオブジェクトを返します。 (Component から継承されます。)
プロテクト メソッド InitializeCommand DbCommand の CommandTimeout、Transaction、CommandType、および UpdateRowSource の各プロパティをリセットします。
プロテクト メソッド MemberwiseClone  オーバーロードされます。 ( MarshalByRefObject から継承されます。)
プロテクト メソッド RowUpdatingHandler RowUpdating イベントのイベント ハンドラを追加します。
プロテクト メソッド SetRowUpdatingHandler DbCommandBuilder を登録して、DbDataAdapter の RowUpdating イベントを処理します。
パブリック イベントパブリック イベント
参照参照

関連項目

DbCommandBuilder クラス
System.Data.Common 名前空間

その他の技術情報

コマンドの自動生成



英和和英テキスト翻訳

英語⇒日本語日本語⇒英語

辞書ショートカット

すべての辞書の索引

「DbCommandBuilder」の関連用語

DbCommandBuilderのお隣キーワード
検索ランキング

   

英語⇒日本語
日本語⇒英語
   



DbCommandBuilderのページの著作権

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2026 Microsoft.All rights reserved.

©2026 GRAS Group, Inc.RSS