OdbcDataAdapter クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
データ コマンドのセットと、DataSet の格納およびデータ ソースの更新に使用されるデータ ソースへの接続を表します。 このクラスは継承できません。
public ref class OdbcDataAdapter sealed : System::Data::Common::DbDataAdapterpublic ref class OdbcDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneablepublic ref class OdbcDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable, System::Data::IDbDataAdapterpublic sealed class OdbcDataAdapter : System.Data.Common.DbDataAdapterpublic sealed class OdbcDataAdapter : System.Data.Common.DbDataAdapter, ICloneablepublic sealed class OdbcDataAdapter : System.Data.Common.DbDataAdapter, ICloneable, System.Data.IDbDataAdaptertype OdbcDataAdapter = class
inherit DbDataAdapter
interface IDataAdapter
interface IDbDataAdapter
interface ICloneabletype OdbcDataAdapter = class
inherit DbDataAdapter
interface IDbDataAdapter
interface IDataAdapter
interface ICloneablePublic NotInheritable Class OdbcDataAdapter
Inherits DbDataAdapterPublic NotInheritable Class OdbcDataAdapter
Inherits DbDataAdapter
Implements ICloneablePublic NotInheritable Class OdbcDataAdapter
Inherits DbDataAdapter
Implements ICloneable, IDbDataAdapter- 継承
- 実装
例
次の例では、、OdbcDataAdapter、 OdbcConnection を使用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してデータ ソースから にDataSetUpdateデータを読み込み、 で行われたDataSet変更をデータ ソースに送信することで、このブリッジを提供します。
が OdbcDataAdapter を DataSet塗りつぶすと、返されたデータに必要なテーブルと列が作成されます (まだ存在しない場合)。 ただし、 プロパティが に設定されていない限り MissingSchemaAction 、主キー情報は暗黙的に作成されたスキーマに AddWithKey含まれません。 また、 を使用FillSchemaしてデータをOdbcDataAdapter入力する前にDataSet、主キー情報を含む のスキーマを作成することもできます。 詳細については、「 DataSet への既存の制約の追加」を参照してください。
注意
主キー列がないデータ ソースで メソッドを呼び出 Fill すと、 OdbcDataAdapter は一意制約列を主キーに昇格しようとします。 プロセスでは、 は OdbcDataAdapter 一意制約を null 許容としてマークします。 この動作は、一意制約列に null 値がない限り機能します。 null 値がある場合、メソッドは Fill 制約違反で失敗します。 この状況を回避するには、一意制約列で null 値を許可しないでください。
注意
ネイティブ ODBC ドライバーの制限により、 を呼び出FillSchemaすときに返されるのは 1 つだけDataTableです。 これは、複数 DataTable のオブジェクトが想定される SQL バッチ ステートメントを実行する場合でも当てはまります。
OdbcDataAdapterには、、、DeleteCommand、UpdateCommandおよび TableMappings の各プロパティも含SelectCommandInsertCommandまれており、データの読み込みと更新を容易にします。
コンストラクター
| 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
フィードバック
近日公開予定: 2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub イシューを段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、以下を参照してください: https://aka.ms/ContentUserFeedback。
フィードバックの送信と表示