OracleCommandBuilder クラスとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

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

public sealed class OracleCommandBuilder :
 DbCommandBuilder

C++

public ref class OracleCommandBuilder sealed
 : public DbCommandBuilder

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) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。