DbCommandBuilder イベント
DbCommandBuilder クラス
アセンブリ: System.Data (system.data.dll 内)
構文解説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.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
スレッド セーフプラットフォームWindows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照DbCommandBuilder コンストラクタ
アセンブリ: System.Data (system.data.dll 内)
構文プラットフォームWindows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照DbCommandBuilder プロパティ
パブリック プロパティ| 名前 | 説明 | |
|---|---|---|
.gif) | Container | Component を格納している IContainer を取得します。 ( Component から継承されます。) |
.gif) | Site | Component の ISite を取得または設定します。 ( Component から継承されます。) |
プロテクト プロパティ| 名前 | 説明 | |
|---|---|---|
.gif) | CanRaiseEvents | コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。 ( Component から継承されます。) |
| | DesignMode | Component が現在デザイン モードかどうかを示す値を取得します。 ( Component から継承されます。) |
| | Events | Component に結び付けられているイベント ハンドラのリストを取得します。 ( Component から継承されます。) |
参照DbCommandBuilder メソッド
パブリック メソッド.gif)
プロテクト メソッド| 名前 | 説明 | |
|---|---|---|
| | ApplyParameterInfo | DbCommandBuilder クラスのプロバイダの実装が、追加パラメータのプロパティを処理できるようにします。 |
| | Dispose | オーバーロードされます。 オーバーライドされます。 DbCommandBuilder によって使用されているリソースを解放します。 |
| | Finalize | Component がガベージ コレクションによってクリアされる前に、アンマネージ リソースを解放し、その他のクリーンアップ操作を実行します。 ( Component から継承されます。) |
| | GetParameterName | オーバーロードされます。 指定したパラメータの名前を返します。 |
| | GetParameterPlaceholder | 関連付けられた SQL ステートメントのパラメータのプレースホルダを返します。 |
| | GetSchemaTable | DbCommandBuilder に対するスキーマ テーブルを返します。 |
.gif) | GetService | Component またはその Container で提供されるサービスを表すオブジェクトを返します。 ( Component から継承されます。) |
| | InitializeCommand | DbCommand の CommandTimeout、Transaction、CommandType、および UpdateRowSource の各プロパティをリセットします。 |
| | MemberwiseClone | オーバーロードされます。 ( MarshalByRefObject から継承されます。) |
| | RowUpdatingHandler | RowUpdating イベントのイベント ハンドラを追加します。 |
| | SetRowUpdatingHandler | DbCommandBuilder を登録して、DbDataAdapter の RowUpdating イベントを処理します。 |
参照DbCommandBuilder メンバ
データベースに関連付けられた DataSet への変更を調整するための単一テーブル コマンドを自動的に生成します。これは抽象クラスであり、継承以外はできません。
DbCommandBuilder データ型で公開されるメンバを以下の表に示します。
プロテクト コンストラクタパブリック プロパティ| 名前 | 説明 | |
|---|---|---|
| | Container | Component を格納している IContainer を取得します。(Component から継承されます。) |
| | Site | Component の ISite を取得または設定します。(Component から継承されます。) |
プロテクト プロパティ| 名前 | 説明 | |
|---|---|---|
| | CanRaiseEvents | コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。(Component から継承されます。) |
| | DesignMode | Component が現在デザイン モードかどうかを示す値を取得します。(Component から継承されます。) |
| | Events | Component に結び付けられているイベント ハンドラのリストを取得します。(Component から継承されます。) |
パブリック メソッドプロテクト メソッド| 名前 | 説明 | |
|---|---|---|
| | 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のページへのリンク
