OleDbDataAdapter クラス

定義

public ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable, System::Data::IDbDataAdapter

public ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable

public sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter, ICloneable, System.Data.IDbDataAdapter

public sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter, ICloneable

type OleDbDataAdapter = class
    inherit DbDataAdapter
    interface IDbDataAdapter
    interface IDataAdapter
    interface ICloneable

Public NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneable, IDbDataAdapter

Public NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneable

継承

Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter

OleDbDataAdapter

実装

IDataAdapter IDbDataAdapter ICloneable

例

次の例では、 OleDbCommand、 OleDbDataAdapter 、 OleDbConnectionを使用して Access データ ソースからレコードを選択し、選択した行を DataSet に設定します。 その後、塗りつぶされた DataSet が返されます。 これを実現するために、メソッドには、初期化された DataSet、接続文字列、および SQL SELECT ステートメントであるクエリ文字列が渡されます。

public static OleDbDataAdapter CreateDataAdapter(string selectCommand,
    OleDbConnection connection)
{
    OleDbDataAdapter adapter = new OleDbDataAdapter(selectCommand, connection);

    adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey;

    // Create the Insert, Update and Delete commands.
    adapter.InsertCommand = new OleDbCommand(
        "INSERT INTO Customers (CustomerID, CompanyName) " +
        "VALUES (?, ?)");

    adapter.UpdateCommand = new OleDbCommand(
        "UPDATE Customers SET CustomerID = ?, CompanyName = ? " +
        "WHERE CustomerID = ?");

    adapter.DeleteCommand = new OleDbCommand(
        "DELETE FROM Customers WHERE CustomerID = ?");

    // Create the parameters.
    adapter.InsertCommand.Parameters.Add("@CustomerID",
        OleDbType.Char, 5, "CustomerID");
    adapter.InsertCommand.Parameters.Add("@CompanyName",
        OleDbType.VarChar, 40, "CompanyName");

    adapter.UpdateCommand.Parameters.Add("@CustomerID",
        OleDbType.Char, 5, "CustomerID");
    adapter.UpdateCommand.Parameters.Add("@CompanyName",
        OleDbType.VarChar, 40, "CompanyName");
    adapter.UpdateCommand.Parameters.Add("@oldCustomerID",
        OleDbType.Char, 5, "CustomerID").SourceVersion =
        DataRowVersion.Original;

    adapter.DeleteCommand.Parameters.Add("@CustomerID",
        OleDbType.Char, 5, "CustomerID").SourceVersion =
        DataRowVersion.Original;

    return adapter;
}

Public Function CreateDataAdapter(ByVal selectCommand As String, _
    ByVal connection As OleDbConnection) As OleDbDataAdapter

    Dim adapter As OleDbDataAdapter = _
        New OleDbDataAdapter(selectCommand, connection)

    adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey

    ' Create the commands.
    adapter.InsertCommand = New OleDbCommand( _
        "INSERT INTO Customers (CustomerID, CompanyName) " & _
         "VALUES (?, ?)")

    adapter.UpdateCommand = New OleDbCommand( _
        "UPDATE Customers SET CustomerID = ?, CompanyName = ? " & _
        "WHERE CustomerID = ?")

    adapter.DeleteCommand = New OleDbCommand( _
        "DELETE FROM Customers WHERE CustomerID = ?")

    ' Create the parameters.
    adapter.InsertCommand.Parameters.Add( _
        "@CustomerID", OleDbType.Char, 5, "CustomerID")
    adapter.InsertCommand.Parameters.Add( _
        "@CompanyName", OleDbType.VarChar, 40, "CompanyName")

    adapter.UpdateCommand.Parameters.Add( _
        "@CustomerID", OleDbType.Char, 5, "CustomerID")
    adapter.UpdateCommand.Parameters.Add( _
        "@CompanyName", OleDbType.VarChar, 40, "CompanyName")
    adapter.UpdateCommand.Parameters.Add( _
        "@oldCustomerID", OleDbType.Char, 5, "CustomerID").SourceVersion = _
        DataRowVersion.Original

    adapter.DeleteCommand.Parameters.Add( _
        "@CustomerID", OleDbType.Char, 5, "CustomerID").SourceVersion = _
        DataRowVersion.Original

    Return adapter
End Function

注釈

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

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

MSDataShape プロバイダーを含む一部の OLE DB プロバイダーでは、ベース テーブルまたは主キー情報が返されないことに注意してください。 そのため、OleDbDataAdapterは、作成されたPrimaryKeyのDataTable プロパティを正しく設定できません。 このような場合は、 DataSetのテーブルの主キーを明示的に指定する必要があります。

OleDbDataAdapterには、データの読み込みと更新を容易にするために、SelectCommand、InsertCommand、DeleteCommand、UpdateCommand、およびTableMappingsプロパティも含まれています。

OleDbDataAdapterのインスタンスを作成すると、プロパティは初期値に設定されます。 これらの値の一覧については、 OleDbDataAdapter コンストラクターを参照してください。

こちらもご覧ください

• DataAdapter と DataReader