OdbcDataAdapter クラス

定義

データ コマンドのセットと、DataSet の格納およびデータ ソースの更新に使用されるデータ ソースへの接続を表します。 このクラスは継承できません。

public ref class OdbcDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable
public ref class OdbcDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable, System::Data::IDbDataAdapter
public ref class OdbcDataAdapter sealed : System::Data::Common::DbDataAdapter
public sealed class OdbcDataAdapter : System.Data.Common.DbDataAdapter, ICloneable
public sealed class OdbcDataAdapter : System.Data.Common.DbDataAdapter, ICloneable, System.Data.IDbDataAdapter
public sealed class OdbcDataAdapter : System.Data.Common.DbDataAdapter
type OdbcDataAdapter = class
    inherit DbDataAdapter
    interface IDataAdapter
    interface IDbDataAdapter
    interface ICloneable
type OdbcDataAdapter = class
    inherit DbDataAdapter
    interface IDbDataAdapter
    interface IDataAdapter
    interface ICloneable
Public NotInheritable Class OdbcDataAdapter
Inherits DbDataAdapter
Implements ICloneable
Public NotInheritable Class OdbcDataAdapter
Inherits DbDataAdapter
Implements ICloneable, IDbDataAdapter
Public NotInheritable Class OdbcDataAdapter
Inherits DbDataAdapter
継承
実装

次の例では、 をOdbcDataAdapterOdbcConnection使用OdbcCommandしてレコードを選択し、選択した行を DataSet に設定します。

public DataSet GetDataSetFromAdapter(
    DataSet dataSet, string connectionString, string queryString)
{
    using (OdbcConnection connection =
               new OdbcConnection(connectionString))
    {
        OdbcDataAdapter adapter =
            new OdbcDataAdapter(queryString, connection);

        // Open the connection and fill the DataSet.
        try
        {
            connection.Open();
            adapter.Fill(dataSet);
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }
    return dataSet;
}
Public Function GetDataSetFromAdapter( _
    ByVal dataSet As DataSet, ByVal connectionString As String, _
    ByVal queryString As String) As DataSet

    Using connection As New OdbcConnection(connectionString)
        Dim adapter As New OdbcDataAdapter(queryString, connection)

        ' Open the connection and fill the DataSet.
        Try
            connection.Open()
            adapter.Fill(dataSet)
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
        ' The connection is automatically closed when the
        ' code exits the Using block.
    End Using

    Return dataSet
End Function

注釈

OdbcDataAdapter 、データを取得および保存するための データ ソースと データ ソースの間 DataSet のブリッジとして機能します。 はOdbcDataAdapter、 を使用してFillデータ ソースDataSetから にデータを読み込み、 でDataSet行われた変更をUpdateデータ ソースに送信することで、このブリッジを提供します。

OdbcDataAdapterDataSet塗りつぶすと、返されるデータに必要なテーブルと列がまだ存在しない場合に作成されます。 ただし、 プロパティが に設定AddWithKeyされていない限りMissingSchemaAction、暗黙的に作成されたスキーマには主キー情報は含まれません。 また、 を使用してFillSchemaデータをOdbcDataAdapter入力する前にDataSet、主キー情報を含む のスキーマを作成することもできます。 詳細については、「 DataSet への既存の制約の追加」を参照してください。

注意

主キー列を持たないデータ ソースで メソッドを呼び出 Fill すと、 OdbcDataAdapter 一意の制約列を主キーに昇格しようとします。 このプロセスでは、 によって OdbcDataAdapter 一意の制約が null 許容としてマークされます。 この動作は、一意の制約列に null 値がない限り機能します。 null 値がある場合、 Fill メソッドは制約違反で失敗します。 このような状況を回避するには、一意の制約列で null 値を許可しないでください。

注意

ネイティブ ODBC ドライバーの制限により、 を呼び出FillSchemaすと 1 つだけDataTableが返されます。 これは、複数 DataTable のオブジェクトが想定される SQL バッチ ステートメントを実行する場合でも当てはまります。

OdbcDataAdapterには、データのSelectCommandUpdateCommandInsertCommandDeleteCommandTableMappings読み込みと更新を容易にする、および の各プロパティも含まれています。

コンストラクター

OdbcDataAdapter()

OdbcDataAdapter クラスの新しいインスタンスを初期化します。

OdbcDataAdapter(OdbcCommand)

指定した SQL SELECT ステートメントを使用して、OdbcDataAdapter クラスの新しいインスタンスを初期化します。

OdbcDataAdapter(String, OdbcConnection)

SQL SELECT ステートメントと OdbcDataAdapter を使用して、OdbcConnection クラスの新しいインスタンスを初期化します。

OdbcDataAdapter(String, String)

SQL SELECT ステートメントと接続文字列を使用して、OdbcDataAdapter クラスの新しいインスタンスを初期化します。

フィールド

DefaultSourceTableName

DataAdapter オブジェクトがテーブル マップに使用する既定の名前。

(継承元 DbDataAdapter)

プロパティ

AcceptChangesDuringFill

Fill 操作中に DataTableDataRow が追加された後で、その行に対して AcceptChanges() を呼び出すかどうかを示す値を取得または設定します。

(継承元 DataAdapter)
AcceptChangesDuringUpdate

AcceptChanges()Update(DataSet) が呼び出されるかどうかを取得または設定します。

(継承元 DataAdapter)
CanRaiseEvents

コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。

(継承元 Component)
Container

IContainer を含む Component を取得します。

(継承元 Component)
ContinueUpdateOnError

行の更新中にエラーが発生したときに、例外を生成するかどうかを指定する値を取得または設定します。

(継承元 DataAdapter)
DeleteCommand

データ ソース内のレコードを削除するための SQL ステートメントまたはストアド プロシージャを取得または設定します。

DesignMode

Component が現在デザイン モードかどうかを示す値を取得します。

(継承元 Component)
Events

Component に結び付けられているイベント ハンドラーのリストを取得します。

(継承元 Component)
FillCommandBehavior

データ アダプターにデータを読み込むコマンドの動作を取得または設定します。

(継承元 DbDataAdapter)
FillLoadOption

アダプターが LoadOption から DataTable にデータを読み込む方法を決定する DbDataReader を取得または設定します。

(継承元 DataAdapter)
InsertCommand

データ ソースに新しいレコードを挿入するために使用する SQL ステートメントまたはストアド プロシージャを取得または設定します。

MissingMappingAction

一致するテーブルまたは列が受信データに含まれていない場合に実行するアクションを決定します。

(継承元 DataAdapter)
MissingSchemaAction

既存の DataSet スキーマが受信データと一致しないときに実行するアクションを決定します。

(継承元 DataAdapter)
ReturnProviderSpecificTypes

Fill メソッドがプロバイダー固有の値、または共通の CLS 準拠の値のどちらを返すかを取得または設定します。

(継承元 DataAdapter)
SelectCommand

データ ソース内のレコードを選択するための SQL ステートメントまたはストアド プロシージャを取得または設定します。

Site

ComponentISite を取得または設定します。

(継承元 Component)
TableMappings

ソース テーブルと の間のプライマリ マッピングを提供するコレクションを DataTable取得します。

(継承元 DataAdapter)
UpdateBatchSize

バッチ処理サポートを有効にするかどうか、および、1 回のバッチで実行可能なコマンド数を指定する値を取得または設定します。

(継承元 DbDataAdapter)
UpdateCommand

データ ソースのレコードを更新するために使用する SQL ステートメントまたはストアド プロシージャを取得または設定します。

メソッド

AddToBatch(IDbCommand)

IDbCommand を現在のバッチに追加します。

(継承元 DbDataAdapter)
ClearBatch()

バッチからすべての IDbCommand オブジェクトを削除します。

(継承元 DbDataAdapter)
CloneInternals()
古い.
古い.
古い.
古い.

この DataAdapter のインスタンスのコピーを作成します。

(継承元 DataAdapter)
CreateObjRef(Type)

リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。

(継承元 MarshalByRefObject)
CreateRowUpdatedEvent(DataRow, IDbCommand, StatementType, DataTableMapping)

RowUpdatedEventArgs クラスの新しいインスタンスを初期化します。

(継承元 DbDataAdapter)
CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping)

RowUpdatingEventArgs クラスの新しいインスタンスを初期化します。

(継承元 DbDataAdapter)
CreateTableMappings()

新しい DataTableMappingCollection を作成します。

(継承元 DataAdapter)
Dispose()

Component によって使用されているすべてのリソースを解放します。

(継承元 Component)
Dispose(Boolean)

DbDataAdapter によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。

(継承元 DbDataAdapter)
Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
ExecuteBatch()

現在のバッチを実行します。

(継承元 DbDataAdapter)
Fill(DataSet)

DataSet 内の行を追加または更新します。

(継承元 DbDataAdapter)
Fill(DataSet, Int32, Int32, String)

DataSet 名および DataSet 名を使用して、データ ソース内の行と一致するように、DataTable 内の指定した範囲の行を追加または更新します。

(継承元 DbDataAdapter)
Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior)

DataSet 名、ソース テーブル名、コマンド文字列、およびコマンド動作を使用して、データ ソース内の列と一致するように、DataSet 内の指定した範囲の行を追加または更新します。

(継承元 DbDataAdapter)
Fill(DataSet, String)

DataSet 名および DataSet 名を使用して、データ ソース内の列と一致するように DataTable 内の行を追加または更新します。

(継承元 DbDataAdapter)
Fill(DataSet, String, IDataReader, Int32, Int32)

DataSetDataTableIDataReader の名前を使用して、データ ソース内の行と一致するように、DataSet 内の指定した範囲の行を追加または更新します。

(継承元 DbDataAdapter)
Fill(DataTable)

DataSet 名を使用して、データ ソース内の行と一致するように、DataTable 内の指定した範囲の行を追加または更新します。

(継承元 DbDataAdapter)
Fill(DataTable, IDataReader)

指定した DataTableIDataReader の名前を使用して、データ ソース内の行と一致するように、DataTable 内の行を追加または更新します。

(継承元 DbDataAdapter)
Fill(DataTable, IDbCommand, CommandBehavior)

指定した DataTableDataTable、および IDbCommand を使用して、データ ソース内の行と一致するように、CommandBehavior 内の行を追加または更新します。

(継承元 DbDataAdapter)
Fill(DataTable[], IDataReader, Int32, Int32)

データ ソース内の行と一致するように、DataTable オブジェクトのコレクション内の指定した範囲の行を追加または更新します。

(継承元 DataAdapter)
Fill(DataTable[], Int32, Int32, IDbCommand, CommandBehavior)

DataSet 名および DataSet 名を使用して、データ ソース内の行と一致するように、DataTable 内の指定した範囲の行を追加または更新します。

(継承元 DbDataAdapter)
Fill(Int32, Int32, DataTable[])

1 つ以上 DataTable のオブジェクトの行を追加または更新して、指定したレコードから始まり、指定した最大数のレコードを取得するデータ ソース内の行と一致させます。

(継承元 DbDataAdapter)
FillSchema(DataSet, SchemaType)

"Table" という名前の DataTable を指定された DataSet に追加し、指定された SchemaType に基づいて、データ ソースにあるスキーマと一致するようにスキーマを構成します。

(継承元 DbDataAdapter)
FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior)

指定した DataTableDataSet を追加し、指定した SchemaType に基づいて、データ ソース内のスキーマと一致するようにスキーマを設定します。

(継承元 DbDataAdapter)
FillSchema(DataSet, SchemaType, String)

指定した DataSetDataTable を追加し、指定した SchemaType および DataTable に基づいて、データ ソースにあるスキーマと一致するようにスキーマを構成します。

(継承元 DbDataAdapter)
FillSchema(DataSet, SchemaType, String, IDataReader)

DataTable を指定した DataSet に追加します。

(継承元 DataAdapter)
FillSchema(DataTable, SchemaType)

指定された SchemaType に基づいて、指定された DataTable のスキーマを構成します。

(継承元 DbDataAdapter)
FillSchema(DataTable, SchemaType, IDataReader)

DataTable を指定した DataSet に追加します。

(継承元 DataAdapter)
FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior)

指定した DataTable、コマンド文字列、および SchemaType 値に基づいて、指定した CommandBehavior のスキーマを設定します。

(継承元 DbDataAdapter)
GetBatchedParameter(Int32, Int32)

現在のバッチのコマンドの 1 つから IDataParameter を返します。

(継承元 DbDataAdapter)
GetBatchedRecordsAffected(Int32, Int32, Exception)

バッチ更新内の、個々の更新の試行に関する情報を返します。

(継承元 DbDataAdapter)
GetFillParameters()

SQL SELECT ステートメントの実行時にユーザーが設定したパラメーターを取得します。

(継承元 DbDataAdapter)
GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetLifetimeService()
古い.

対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。

(継承元 MarshalByRefObject)
GetService(Type)

Component またはその Container で提供されるサービスを表すオブジェクトを返します。

(継承元 Component)
GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
HasTableMappings()

DataTableMappingCollection が作成されているかどうかを示します。

(継承元 DataAdapter)
InitializeBatching()

DbDataAdapter のバッチ処理を初期化します。

(継承元 DbDataAdapter)
InitializeLifetimeService()
古い.

このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。

(継承元 MarshalByRefObject)
MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
MemberwiseClone(Boolean)

現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。

(継承元 MarshalByRefObject)
OnFillError(FillErrorEventArgs)

FillError イベントを発生させます。

(継承元 DbDataAdapter)
OnRowUpdated(RowUpdatedEventArgs)

.NET データ プロバイダーの RowUpdated イベントを発生させます。

(継承元 DbDataAdapter)
OnRowUpdating(RowUpdatingEventArgs)

.NET データ プロバイダーの RowUpdating イベントを発生させます。

(継承元 DbDataAdapter)
ResetFillLoadOption()

FillLoadOption を既定の状態にリセットし、Fill(DataSet)AcceptChangesDuringFill を受け入れるようにします。

(継承元 DataAdapter)
ShouldSerializeAcceptChangesDuringFill()

AcceptChangesDuringFill プロパティを永続化する必要があるかどうかを判断します。

(継承元 DataAdapter)
ShouldSerializeFillLoadOption()

FillLoadOption プロパティを永続化する必要があるかどうかを判断します。

(継承元 DataAdapter)
ShouldSerializeTableMappings()

1 つ以上の DataTableMapping オブジェクトが存在し、それらを永続化する必要があるかどうかを確認します。

(継承元 DataAdapter)
TerminateBatching()

DbDataAdapter のバッチ処理を終了します。

(継承元 DbDataAdapter)
ToString()

Component の名前 (存在する場合) を格納する String を返します。 このメソッドはオーバーライドできません。

(継承元 Component)
Update(DataRow[])

指定した DataSet 内の配列での挿入行、更新行、または削除行に対して INSERT、UPDATE、または DELETE ステートメントを個別に実行することで、データベースの値を更新します。

(継承元 DbDataAdapter)
Update(DataRow[], DataTableMapping)

指定した DataRow オブジェクトの配列内の挿入行、更新行、または削除行に対して INSERT、UPDATE、または DELETE ステートメントを個別に実行することで、データベースの値を更新します。

(継承元 DbDataAdapter)
Update(DataSet)

指定した DataSet での挿入行、更新行、または削除行に対して INSERT、UPDATE、または DELETE ステートメントを個別に実行することで、データベースの値を更新します。

(継承元 DbDataAdapter)
Update(DataSet, String)

DataSet 内の指定した DataTable 名を持つ挿入行、更新行、または削除行に対して INSERT、UPDATE、または DELETE ステートメントを個別に実行することで、データベースの値を更新します。

(継承元 DbDataAdapter)
Update(DataTable)

指定した DataTable での挿入行、更新行、または削除行に対して INSERT、UPDATE、または DELETE ステートメントを個別に実行することで、データベースの値を更新します。

(継承元 DbDataAdapter)

イベント

Disposed

Dispose() メソッドの呼び出しによってコンポーネントが破棄されるときに発生します。

(継承元 Component)
FillError

格納操作中にエラーが発生したときに返されます。

(継承元 DbDataAdapter)
RowUpdated

更新操作中に、データ ソースに対してコマンドが実行された後に発生します。

RowUpdating

Update(DataSet) 処理中に、データ ソースに対してコマンドが実行される前に発生します。

明示的なインターフェイスの実装

ICloneable.Clone()

このメンバーの詳細については、「Clone()」をご覧ください。

IDataAdapter.TableMappings

ソース テーブルをデータセット テーブルにマップする方法を示すコレクションを取得します。

(継承元 DataAdapter)
IDbDataAdapter.DeleteCommand

このメンバーの詳細については、「DeleteCommand」をご覧ください。

IDbDataAdapter.InsertCommand

このメンバーの詳細については、「InsertCommand」をご覧ください。

IDbDataAdapter.SelectCommand

このメンバーの詳細については、「SelectCommand」をご覧ください。

IDbDataAdapter.UpdateCommand

このメンバーの詳細については、「UpdateCommand」をご覧ください。

適用対象

こちらもご覧ください