OracleCommandBuilder

.NET Framework クラス ライブラリ リファレンス

OracleCommandBuilder イベント

パブリック イベント

	名前	説明
	Disposed	コンポーネントの Disposed イベントを待機するイベント ハンドラを追加します。 ( Component から継承されます。)

参照

関連項目

OracleCommandBuilder クラス
System.Data.OracleClient 名前空間

その他の技術情報

コマンドの自動生成

OracleCommandBuilder クラス

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

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

Visual Basic (宣言)

Public NotInheritable Class
 OracleCommandBuilder
    Inherits DbCommandBuilder

Visual Basic (使用法)

Dim instance As OracleCommandBuilder

C#

public sealed class OracleCommandBuilder :
 DbCommandBuilder

C++

public ref class OracleCommandBuilder sealed
 : public DbCommandBuilder

J#

public final class OracleCommandBuilder extends
 DbCommandBuilder

JScript

public final class OracleCommandBuilder extends
 DbCommandBuilder

解説

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

OracleDataAdapter とそれに対応する OracleCommandBuilder 間のリレーションシップは、常に 1 対 1 です。この対応を作成するには、OracleCommandBuilder オブジェクトの OracleDataAdapter プロパティを設定します。その結果、OracleCommandBuilder はリスナとして登録され、DataSet を対象とする RowUpdating イベントの出力を生成します。

OracleCommandBuilder では、INSERT、UPDATE、または DELETE ステートメントを生成するために、SelectCommand プロパティを使用して必要なメタデータ セットが取得されます。

また、OracleCommandBuilder では、SelectCommand が参照する Connection プロパティと Transaction プロパティも使用されます。

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

使用例

OracleCommand を OracleDataAdapter および OracleConnection と共に使用して、データベースから行を選択する例を次に示します。この例のコードには、初期化済みの DataSet、接続文字列、クエリ文字列 (SQL SELECT ステートメント)、およびデータベース テーブル名の文字列が渡されます。この例では、続いて、OracleCommandBuilder を作成します。

[Visual Basic]

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

[C#]

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;
}

継承階層

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Data.Common.DbCommandBuilder
        System.Data.OracleClient.OracleCommandBuilder

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1

参照

関連項目
OracleCommandBuilder メンバ
System.Data.OracleClient 名前空間
その他の技術情報
コマンドの自動生成

OracleCommandBuilder コンストラクタ ()

OracleCommandBuilder の新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New OracleCommandBuilder

C#

public OracleCommandBuilder ()

C++

public:
OracleCommandBuilder ()

J#

public OracleCommandBuilder ()

JScript

public function OracleCommandBuilder ()

解説

このプロパティで指定した OracleDataAdapter が生成する RowUpdating イベントのリスナとして、OracleCommandBuilder が自動的に登録されます。

新しい OracleCommandBuilder インスタンスを作成すると、この OracleDataAdapter に関連付けられていた既存の OracleCommandBuilder が解放されます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1

参照

関連項目
OracleCommandBuilder クラス
OracleCommandBuilder メンバ
System.Data.OracleClient 名前空間

OracleCommandBuilder コンストラクタ (OracleDataAdapter)

関連付ける OracleDataAdapter オブジェクトを指定して、OracleCommandBuilder クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    adapter As OracleDataAdapter _
)

Visual Basic (使用法)

Dim adapter As OracleDataAdapter

Dim instance As New OracleCommandBuilder(adapter)

C#

public OracleCommandBuilder (
    OracleDataAdapter adapter
)

C++

public:
OracleCommandBuilder (
    OracleDataAdapter^ adapter
)

J#

public OracleCommandBuilder (
    OracleDataAdapter adapter
)

JScript

public function OracleCommandBuilder (
    adapter : OracleDataAdapter
)

パラメータ

adapter

OracleCommandBuilder に関連付ける OracleDataAdapter オブジェクト。

解説

このプロパティで指定した OracleDataAdapter が生成する RowUpdating イベントのリスナとして、OracleCommandBuilder が自動的に登録されます。

新しい OracleCommandBuilder インスタンスを作成すると、この OracleDataAdapter に関連付けられていた既存の OracleCommandBuilder が解放されます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1

参照

関連項目
OracleCommandBuilder クラス
OracleCommandBuilder メンバ
System.Data.OracleClient 名前空間

OracleCommandBuilder コンストラクタ

OracleCommandBuilder の新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
OracleCommandBuilder ()	OracleCommandBuilder の新しいインスタンスを初期化します。
OracleCommandBuilder (OracleDataAdapter)	関連付ける OracleDataAdapter オブジェクトを指定して、OracleCommandBuilder クラスの新しいインスタンスを初期化します。

参照

関連項目

OracleCommandBuilder クラス
OracleCommandBuilder メンバ
System.Data.OracleClient 名前空間

OracleCommandBuilder プロパティ

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	CatalogLocation	オーバーライドされます。 DbCommandBuilder クラスのインスタンスの CatalogLocation を設定または取得します。
	CatalogSeparator	オーバーライドされます。 DbCommandBuilder クラスのインスタンスのカタログの区切り記号として使用する文字列を設定または取得します。
	ConflictOption	DbCommandBuilder で使用する ConflictOption を指定します。 ( DbCommandBuilder から継承されます。)
	Container	Component を格納している IContainer を取得します。 ( Component から継承されます。)
	DataAdapter	この OracleCommandBuilder オブジェクトが生成する SQL ステートメントの対象となる OracleDataAdapter オブジェクトを取得または設定します。
	QuotePrefix	名前に空白や予約済みトークンなどの文字を含むデータベース オブジェクト (テーブル、列など) を指定するための開始文字を取得または設定します。 ( DbCommandBuilder から継承されます。)
	QuoteSuffix	名前に空白や予約済みトークンなどの文字を含むデータベース オブジェクト (テーブル、列など) を指定するための開始文字を取得または設定します。 ( DbCommandBuilder から継承されます。)
	SchemaSeparator	オーバーライドされます。 スキーマ ID とその他の ID の間の区切り記号に使用する文字列を取得または設定します。
	SetAllValues	UPDATE ステートメントにすべての列値が含まれるのか、変更になった列値だけが含まれるのかを示します。 ( DbCommandBuilder から継承されます。)
	Site	Component の ISite を取得または設定します。 ( Component から継承されます。)

プロテクト プロパティ

	名前	説明
	CanRaiseEvents	コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。 ( Component から継承されます。)
	DesignMode	Component が現在デザイン モードかどうかを示す値を取得します。 ( Component から継承されます。)
	Events	Component に結び付けられているイベント ハンドラのリストを取得します。 ( Component から継承されます。)

参照

関連項目

OracleCommandBuilder クラス
System.Data.OracleClient 名前空間

その他の技術情報

コマンドの自動生成

OracleCommandBuilder メソッド

パブリック メソッド

( プロテクト メソッド も参照)

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

プロテクト メソッド

	名前	説明
	ApplyParameterInfo	DbCommandBuilder クラスのプロバイダの実装が、追加パラメータのプロパティを処理できるようにします。 ( DbCommandBuilder から継承されます。)
	Dispose	オーバーロードされます。 DbCommandBuilder によって使用されているリソースを解放します。 ( DbCommandBuilder から継承されます。)
	Finalize	Component がガベージ コレクションによってクリアされる前に、アンマネージ リソースを解放し、その他のクリーンアップ操作を実行します。 ( Component から継承されます。)
	GetParameterName	オーバーロードされます。 指定したパラメータの名前を返します。 ( DbCommandBuilder から継承されます。)
	GetParameterPlaceholder	関連付けられた SQL ステートメントのパラメータのプレースホルダを返します。 ( DbCommandBuilder から継承されます。)
	GetSchemaTable	DbCommandBuilder に対するスキーマ テーブルを返します。 ( DbCommandBuilder から継承されます。)
	GetService	Component またはその Container で提供されるサービスを表すオブジェクトを返します。 ( Component から継承されます。)
	InitializeCommand	DbCommand の CommandTimeout、Transaction、CommandType、および UpdateRowSource の各プロパティをリセットします。 ( DbCommandBuilder から継承されます。)
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)
	RowUpdatingHandler	RowUpdating イベントのイベント ハンドラを追加します。 ( DbCommandBuilder から継承されます。)
	SetRowUpdatingHandler	DbCommandBuilder を登録して、DbDataAdapter の RowUpdating イベントを処理します。 ( DbCommandBuilder から継承されます。)

参照

関連項目

OracleCommandBuilder クラス
System.Data.OracleClient 名前空間

その他の技術情報

コマンドの自動生成

OracleCommandBuilder メンバ

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

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

パブリック コンストラクタ

	名前	説明
	OracleCommandBuilder	オーバーロードされます。 OracleCommandBuilder の新しいインスタンスを初期化します。

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	CatalogLocation	オーバーライドされます。 DbCommandBuilder クラスのインスタンスの CatalogLocation を設定または取得します。
	CatalogSeparator	オーバーライドされます。 DbCommandBuilder クラスのインスタンスのカタログの区切り記号として使用する文字列を設定または取得します。
	ConflictOption	DbCommandBuilder で使用する ConflictOption を指定します。(DbCommandBuilder から継承されます。)
	Container	Component を格納している IContainer を取得します。(Component から継承されます。)
	DataAdapter	この OracleCommandBuilder オブジェクトが生成する SQL ステートメントの対象となる OracleDataAdapter オブジェクトを取得または設定します。
	QuotePrefix	名前に空白や予約済みトークンなどの文字を含むデータベース オブジェクト (テーブル、列など) を指定するための開始文字を取得または設定します。(DbCommandBuilder から継承されます。)
	QuoteSuffix	名前に空白や予約済みトークンなどの文字を含むデータベース オブジェクト (テーブル、列など) を指定するための開始文字を取得または設定します。(DbCommandBuilder から継承されます。)
	SchemaSeparator	オーバーライドされます。 スキーマ ID とその他の ID の間の区切り記号に使用する文字列を取得または設定します。
	SetAllValues	UPDATE ステートメントにすべての列値が含まれるのか、変更になった列値だけが含まれるのかを示します。(DbCommandBuilder から継承されます。)
	Site	Component の ISite を取得または設定します。(Component から継承されます。)

プロテクト プロパティ

	名前	説明
	CanRaiseEvents	コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。(Component から継承されます。)
	DesignMode	Component が現在デザイン モードかどうかを示す値を取得します。(Component から継承されます。)
	Events	Component に結び付けられているイベント ハンドラのリストを取得します。(Component から継承されます。)

パブリック メソッド

( プロテクト メソッド も参照)

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

プロテクト メソッド

	名前	説明
	ApplyParameterInfo	DbCommandBuilder クラスのプロバイダの実装が、追加パラメータのプロパティを処理できるようにします。 (DbCommandBuilder から継承されます。)
	Dispose	オーバーロードされます。 DbCommandBuilder によって使用されているリソースを解放します。 (DbCommandBuilder から継承されます。)
	Finalize	Component がガベージ コレクションによってクリアされる前に、アンマネージ リソースを解放し、その他のクリーンアップ操作を実行します。 (Component から継承されます。)
	GetParameterName	オーバーロードされます。 指定したパラメータの名前を返します。 (DbCommandBuilder から継承されます。)
	GetParameterPlaceholder	関連付けられた SQL ステートメントのパラメータのプレースホルダを返します。 (DbCommandBuilder から継承されます。)
	GetSchemaTable	DbCommandBuilder に対するスキーマ テーブルを返します。 (DbCommandBuilder から継承されます。)
	GetService	Component またはその Container で提供されるサービスを表すオブジェクトを返します。 (Component から継承されます。)
	InitializeCommand	DbCommand の CommandTimeout、Transaction、CommandType、および UpdateRowSource の各プロパティをリセットします。 (DbCommandBuilder から継承されます。)
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)
	RowUpdatingHandler	RowUpdating イベントのイベント ハンドラを追加します。 (DbCommandBuilder から継承されます。)
	SetRowUpdatingHandler	DbCommandBuilder を登録して、DbDataAdapter の RowUpdating イベントを処理します。 (DbCommandBuilder から継承されます。)

パブリック イベント

	名前	説明
	Disposed	コンポーネントの Disposed イベントを待機するイベント ハンドラを追加します。(Component から継承されます。)

参照

関連項目

OracleCommandBuilder クラス
System.Data.OracleClient 名前空間

その他の技術情報

コマンドの自動生成