OdbcDataAdapter クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
データ コマンドのセットと、 DataSet の入力とデータ ソースの更新に使用されるデータ ソースへの接続を表します。 このクラスは継承できません。
public ref class OdbcDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable, System::Data::IDbDataAdapterpublic ref class OdbcDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneablepublic sealed class OdbcDataAdapter : System.Data.Common.DbDataAdapter, ICloneable, System.Data.IDbDataAdapterpublic sealed class OdbcDataAdapter : System.Data.Common.DbDataAdapter, ICloneabletype OdbcDataAdapter = class
inherit DbDataAdapter
interface IDbDataAdapter
interface IDataAdapter
interface ICloneablePublic NotInheritable Class OdbcDataAdapter
Inherits DbDataAdapter
Implements ICloneable, IDbDataAdapterPublic NotInheritable Class OdbcDataAdapter
Inherits DbDataAdapter
Implements ICloneable- 継承
- 実装
例
次の例では、 OdbcCommand、 OdbcDataAdapter、および OdbcConnection を使用してレコードを選択し、選択した行を 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にデータを読み込み、Updateを使用してDataSetで行われた変更をデータ ソースに送信することで、このブリッジを提供します。
OdbcDataAdapterがDataSetに入力されると、返されたデータに必要なテーブルと列がまだ存在しない場合は作成されます。 ただし、 MissingSchemaAction プロパティが AddWithKey に設定されていない限り、主キー情報は暗黙的に作成されるスキーマには含まれません。 また、OdbcDataAdapterを使用してデータを入力する前に、主キー情報を含むDataSetのスキーマを作成FillSchemaがあります。 詳細については、「 DataSet への既存の制約の追加」を参照してください。
Note
主キー列がないデータ ソースで Fill メソッドを呼び出すと、 OdbcDataAdapter は一意制約列を主キーに昇格しようとします。 このプロセスでは、 OdbcDataAdapter は一意制約を null 許容としてマークします。 この動作は、一意の制約列に null 値がない限り機能します。 null 値がある場合、 Fill メソッドは制約違反で失敗します。 このような状況を回避するには、一意制約列で null 値を許可しないでください。
Note
ネイティブ ODBC ドライバーの制限により、DataTableを呼び出すときに返されるFillSchemaは 1 つだけです。 これは、複数の DataTable オブジェクトが想定される SQL バッチ ステートメントを実行する場合でも当てはまります。
OdbcDataAdapterには、データの読み込みと更新を容易にするために、SelectCommand、InsertCommand、DeleteCommand、UpdateCommand、およびTableMappingsのプロパティも含まれています。
コンストラクター
| 名前 | 説明 |
|---|---|
| OdbcDataAdapter() |
OdbcDataAdapter クラスの新しいインスタンスを初期化します。 |
| OdbcDataAdapter(OdbcCommand) |
指定した SQL SELECT ステートメントを使用して、 OdbcDataAdapter クラスの新しいインスタンスを初期化します。 |
| OdbcDataAdapter(String, OdbcConnection) |
SQL SELECT ステートメントとOdbcDataAdapterを使用して、OdbcConnection クラスの新しいインスタンスを初期化します。 |
| OdbcDataAdapter(String, String) |
SQL SELECT ステートメントと接続文字列を使用して、 OdbcDataAdapter クラスの新しいインスタンスを初期化します。 |
フィールド
| 名前 | 説明 |
|---|---|
| DefaultSourceTableName |
テーブル マッピングに DataAdapter オブジェクトによって使用される既定の名前。 (継承元 DbDataAdapter) |
プロパティ
| 名前 | 説明 |
|---|---|
| AcceptChangesDuringFill |
AcceptChanges() 操作の実行中にDataRowにDataTableが追加された後にが呼び出されるかどうかを示す値を取得または設定します。 (継承元 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) |
| TableMappings |
ソース テーブルと DataTableの間のプライマリ マッピングを提供するコレクションを取得します。 (継承元 DataAdapter) |
| UpdateBatchSize |
バッチ処理のサポートを有効または無効にする値を取得または設定し、バッチで実行できるコマンドの数を指定します。 (継承元 DbDataAdapter) |
| UpdateCommand |
データ ソース内のレコードを更新するために使用する SQL ステートメントまたはストアド プロシージャを取得または設定します。 |
メソッド
イベント
| 名前 | 説明 |
|---|---|
| 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を参照してください。 |