OdbcDataAdapter クラス

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

OdbcDataAdapter クラス

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

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

Visual Basic (宣言)

Public NotInheritable Class
 OdbcDataAdapter
    Inherits DbDataAdapter
    Implements IDbDataAdapter, IDataAdapter, ICloneable

Visual Basic (使用法)

Dim instance As OdbcDataAdapter

C#

public sealed class OdbcDataAdapter : DbDataAdapter,
 IDbDataAdapter, IDataAdapter, ICloneable

C++

public ref class OdbcDataAdapter sealed : public
 DbDataAdapter, IDbDataAdapter, IDataAdapter, ICloneable

J#

public final class OdbcDataAdapter extends
 DbDataAdapter implements IDbDataAdapter, IDataAdapter, 
    ICloneable

JScript

public final class OdbcDataAdapter extends
 DbDataAdapter implements IDbDataAdapter, IDataAdapter, 
    ICloneable

解説

OdbcDataAdapter は、DataSet とデータ ソースの間でデータを取得および保存するための、ブリッジの役割を果たします。OdbcDataAdapter は、このブリッジを提供するために、データ ソース内のデータを DataSet に読み込む Fill、および DataSet での変更をデータ ソースに送り返す Update を使用します。

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

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

メモ
ODBC のネイティブ ドライバの制約により、FillSchema を呼び出すと、DataTable は 1 つだけ返されます。これは、複数の DataTable オブジェクトを返す必要がある SQL バッチ ステートメントを実行したときも同じです。

OdbcDataAdapter には、データの読み込みと更新を効率的に行うために、SelectCommand、InsertCommand、DeleteCommand、UpdateCommand、TableMappings の各プロパティも用意されています。

使用例

OdbcCommand、OdbcDataAdapter、および OdbcConnection を使用してレコードを選択し、選択した行を DataSet に格納する例を次に示します。

Visual Basic

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

C#

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

継承階層

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Data.Common.DataAdapter
         System.Data.Common.DbDataAdapter
          System.Data.Odbc.OdbcDataAdapter

スレッド セーフ

この型の 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

参照

関連項目
OdbcDataAdapter メンバ
System.Data.Odbc 名前空間
その他の技術情報
DataAdapter の使用