OdbcCommandBuilder クラス

定義

public ref class OdbcCommandBuilder sealed : System::Data::Common::DbCommandBuilder

public ref class OdbcCommandBuilder sealed : System::ComponentModel::Component

public sealed class OdbcCommandBuilder : System.Data.Common.DbCommandBuilder

public sealed class OdbcCommandBuilder : System.ComponentModel.Component

type OdbcCommandBuilder = class
    inherit DbCommandBuilder

type OdbcCommandBuilder = class
    inherit Component

Public NotInheritable Class OdbcCommandBuilder
Inherits DbCommandBuilder

Public NotInheritable Class OdbcCommandBuilder
Inherits Component

継承

Object

MarshalByRefObject

Component

DbCommandBuilder

OdbcCommandBuilder

継承

Object

MarshalByRefObject

Component

OdbcCommandBuilder

例

次の例では、 と と OdbcConnectionをOdbcDataAdapter使用OdbcCommandして、データ ソースから行を選択します。 この例では、初期化DataSetされた 、接続文字列、SQL SELECT ステートメントであるクエリ文字列、およびデータ ソース テーブルの名前である文字列が渡されます。 次に、 を作成します OdbcCommandBuilder。

public static DataSet SelectOdbcSrvRows(string connectionString,
    string queryString, string tableName)
{
    DataSet dataSet = new DataSet();
    using (OdbcConnection connection = new OdbcConnection(connectionString))
    {
        OdbcDataAdapter adapter = new OdbcDataAdapter();
        adapter.SelectCommand =
            new OdbcCommand(queryString, connection);
        OdbcCommandBuilder builder =
            new OdbcCommandBuilder(adapter);

        connection.Open();

        adapter.Fill(dataSet, tableName);

        //code to modify data in DataSet here

        //Without the OdbcCommandBuilder this line would fail
        adapter.Update(dataSet, tableName);
    }
    return dataSet;
}

Public Function SelectOdbcSrvRows( _
    ByVal connectionString As String, ByVal queryString As String, _
    ByVal tableName As String) As DataSet

    Dim dataSet As New DataSet()

    Using connection As New OdbcConnection(connectionString)
        Dim adapter As New OdbcDataAdapter()
        adapter.SelectCommand = _
            New OdbcCommand(queryString, connection)
        Dim builder As New OdbcCommandBuilder(adapter)

        connection.Open()

        adapter.Fill(dataSet, tableName)

        ' Code to modify data in DataSet here 

        ' Without the OdbcCommandBuilder this line would fail.
        adapter.Update(dataSet, tableName)
    End Using

    Return dataSet
End Function

注釈

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

と対応する OdbcCommandBuilder の間のOdbcDataAdapterリレーションシップは、常に 1 対 1 です。 この対応を作成するには、オブジェクトの プロパティをOdbcDataAdapterOdbcCommandBuilder設定します。 これにより、 OdbcCommandBuilder 自体がリスナーとして登録され、 に影響を与えるイベントの RowUpdating 出力が生成されます DataSet。

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

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

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

コンストラクター

プロパティ

メソッド

イベント

適用対象

こちらもご覧ください

• CommandBuilder でのコマンドの生成