OleDbDataAdapter クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
DataSet へのデータの格納およびデータ ソースの更新に使用される、一連のデータ コマンドおよびデータベース接続を表します。
public ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapterpublic ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneablepublic ref class OleDbDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable, System::Data::IDbDataAdapterpublic sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapterpublic sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter, ICloneablepublic sealed class OleDbDataAdapter : System.Data.Common.DbDataAdapter, ICloneable, System.Data.IDbDataAdaptertype OleDbDataAdapter = class
inherit DbDataAdapter
interface IDataAdapter
interface IDbDataAdapter
interface ICloneabletype OleDbDataAdapter = class
inherit DbDataAdapter
interface IDbDataAdapter
interface IDataAdapter
interface ICloneablePublic NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapterPublic NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneablePublic NotInheritable Class OleDbDataAdapter
Inherits DbDataAdapter
Implements ICloneable, IDbDataAdapter- 継承
- 実装
例
次の例では、 と OleDbDataAdapterOleDbConnectionをOleDbCommand使用して 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してデータ ソースから にDataSetUpdateデータを読み込み、 で行われたDataSet変更をデータ ソースに送信することで、このブリッジを提供します。
が OleDbDataAdapter を DataSet塗りつぶすと、返されたデータの適切なテーブルと列が作成されます (まだ存在しない場合)。 ただし、 プロパティが に設定されていない限り MissingSchemaAction 、主キー情報は暗黙的に作成されたスキーマに AddWithKey含まれません。 また、 を使用FillSchemaしてデータをOleDbDataAdapter入力する前にDataSet、主キー情報を含む のスキーマを作成することもできます。 詳細については、「 DataSet への既存の制約の追加」を参照してください。
MSDataShape プロバイダーを含む一部の OLE DB プロバイダーでは、ベース テーブルまたは主キー情報が返されないことに注意してください。 したがって、 はOleDbDataAdapter、作成DataTableされた に対して プロパティをPrimaryKey正しく設定できません。 このような場合は、 のテーブルの主キーを明示的に指定する DataSet必要があります。
OleDbDataAdapterには、、、DeleteCommand、UpdateCommandおよび TableMappings の各プロパティも含SelectCommandInsertCommandまれており、データの読み込みと更新を容易にします。
の OleDbDataAdapterインスタンスを作成すると、プロパティは初期値に設定されます。 これらの値の一覧については、 コンストラクターを OleDbDataAdapter 参照してください。
コンストラクター
| OleDbDataAdapter() |
OleDbDataAdapter クラスの新しいインスタンスを初期化します。 |
| OleDbDataAdapter(OleDbCommand) |
OleDbDataAdapter プロパティとして OleDbCommand を指定して、SelectCommand クラスの新しいインスタンスを初期化します。 |
| OleDbDataAdapter(String, OleDbConnection) |
OleDbDataAdapter を使用して、SelectCommand クラスの新しいインスタンスを初期化します。 |
| OleDbDataAdapter(String, String) |
OleDbDataAdapter を使用して、SelectCommand クラスの新しいインスタンスを初期化します。 |
フィールド
| DefaultSourceTableName |
DataAdapter オブジェクトがテーブル マップに使用する既定の名前。 (継承元 DbDataAdapter) |
プロパティ
| AcceptChangesDuringFill |
Fill 操作中に DataTable に DataRow が追加された後で、その行に対して 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 |
|
| SelectCommand |
データ ソース内のレコードを選択するための SQL ステートメントまたはストアド プロシージャを取得または設定します。 |
| Site |
Component の ISite を取得または設定します。 (継承元 Component) |
| TableMappings |
ソース テーブルと の間のプライマリ マッピングを提供するコレクションを DataTable取得します。 (継承元 DataAdapter) |
| UpdateBatchSize |
バッチ処理サポートを有効にするかどうか、および、1 回のバッチで実行可能なコマンド数を指定する値を取得または設定します。 (継承元 DbDataAdapter) |
| UpdateCommand |
データ ソースのレコードを更新するために使用する SQL ステートメントまたはストアド プロシージャを取得または設定します。 |
メソッド
イベント
| Disposed |
Dispose() メソッドの呼び出しによってコンポーネントが破棄されるときに発生します。 (継承元 Component) |
| FillError |
格納操作中にエラーが発生したときに返されます。 (継承元 DbDataAdapter) |
| RowUpdated |
Update(DataSet) 処理中に、データ ソースに対してコマンドが実行された後に発生します。 更新処理が試行されました。 そのため、イベントが発生しました。 |
| RowUpdating |
Update(DataSet) 処理中に、データ ソースに対してコマンドが実行される前に発生します。 更新処理が試行されました。 そのため、イベントが発生しました。 |
明示的なインターフェイスの実装
| ICloneable.Clone() |
このメンバーの詳細については、「Clone()」をご覧ください。 |
| IDataAdapter.TableMappings |
ソース テーブルをデータセット テーブルにマップする方法を示すコレクションを取得します。 (継承元 DataAdapter) |
| IDbDataAdapter.DeleteCommand |
このメンバーの詳細については、「DeleteCommand」をご覧ください。 |
| IDbDataAdapter.InsertCommand |
このメンバーの詳細については、「InsertCommand」をご覧ください。 |
| IDbDataAdapter.SelectCommand |
このメンバーの詳細については、「SelectCommand」をご覧ください。 |
| IDbDataAdapter.UpdateCommand |
このメンバーの詳細については、「UpdateCommand」をご覧ください。 |
適用対象
こちらもご覧ください
.NET
フィードバック
近日公開予定: 2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub イシューを段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、以下を参照してください: https://aka.ms/ContentUserFeedback。
フィードバックの送信と表示