OdbcDataAdapter クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
データ コマンドのセットと、DataSet の格納およびデータ ソースの更新に使用されるデータ ソースへの接続を表します。 このクラスは継承できません。
public ref class OdbcDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneablepublic ref class OdbcDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable, System::Data::IDbDataAdapterpublic ref class OdbcDataAdapter sealed : System::Data::Common::DbDataAdapterpublic sealed class OdbcDataAdapter : System.Data.Common.DbDataAdapter, ICloneablepublic sealed class OdbcDataAdapter : System.Data.Common.DbDataAdapter, ICloneable, System.Data.IDbDataAdapterpublic sealed class OdbcDataAdapter : System.Data.Common.DbDataAdaptertype OdbcDataAdapter = class
inherit DbDataAdapter
interface IDataAdapter
interface IDbDataAdapter
interface ICloneabletype OdbcDataAdapter = class
inherit DbDataAdapter
interface IDbDataAdapter
interface IDataAdapter
interface ICloneablePublic NotInheritable Class OdbcDataAdapter
Inherits DbDataAdapter
Implements ICloneablePublic NotInheritable Class OdbcDataAdapter
Inherits DbDataAdapter
Implements ICloneable, IDbDataAdapterPublic 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データ ソースに送信することで、このブリッジを提供します。
が OdbcDataAdapter を DataSet塗りつぶすと、返されるデータに必要なテーブルと列がまだ存在しない場合に作成されます。 ただし、 プロパティが に設定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 操作中に 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 |
更新操作中に、データ ソースに対してコマンドが実行された後に発生します。 |
| RowUpdating |
Update(DataSet) 処理中に、データ ソースに対してコマンドが実行される前に発生します。 |
明示的なインターフェイスの実装
| ICloneable.Clone() |
このメンバーの詳細については、「Clone()」をご覧ください。 |
| IDataAdapter.TableMappings |
ソース テーブルをデータセット テーブルにマップする方法を示すコレクションを取得します。 (継承元 DataAdapter) |
| IDbDataAdapter.DeleteCommand |
このメンバーの詳細については、「DeleteCommand」をご覧ください。 |
| IDbDataAdapter.InsertCommand |
このメンバーの詳細については、「InsertCommand」をご覧ください。 |
| IDbDataAdapter.SelectCommand |
このメンバーの詳細については、「SelectCommand」をご覧ください。 |
| IDbDataAdapter.UpdateCommand |
このメンバーの詳細については、「UpdateCommand」をご覧ください。 |
適用対象
こちらもご覧ください
.NET