SqlDataAdapter クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
DataSetを満たし、SQL Server データベースを更新するために使用される一連のデータ コマンドとデータベース接続を表します。 このクラスは継承できません。
public ref class SqlDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable, System::Data::IDbDataAdapterpublic ref class SqlDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneablepublic sealed class SqlDataAdapter : System.Data.Common.DbDataAdapter, ICloneable, System.Data.IDbDataAdapterpublic sealed class SqlDataAdapter : System.Data.Common.DbDataAdapter, ICloneabletype SqlDataAdapter = class
inherit DbDataAdapter
interface IDbDataAdapter
interface IDataAdapter
interface ICloneablePublic NotInheritable Class SqlDataAdapter
Inherits DbDataAdapter
Implements ICloneable, IDbDataAdapterPublic NotInheritable Class SqlDataAdapter
Inherits DbDataAdapter
Implements ICloneable- 継承
- 実装
例
次の例では、 SqlCommand、 SqlDataAdapter、および SqlConnection を使用してデータベースからレコードを選択し、選択した行を DataSet に設定します。 その後、塗りつぶされた DataSet が返されます。 これを実現するために、メソッドには、初期化された DataSet、接続文字列、および Transact-SQL SELECT ステートメントであるクエリ文字列が渡されます。
private static DataSet SelectRows(DataSet dataset,
string connectionString,string queryString)
{
using (SqlConnection connection =
new SqlConnection(connectionString))
{
SqlDataAdapter adapter = new SqlDataAdapter();
adapter.SelectCommand = new SqlCommand(
queryString, connection);
adapter.Fill(dataset);
return dataset;
}
}
Public Function SelectRows( _
ByVal dataSet As DataSet, ByVal connectionString As String, _
ByVal queryString As String) As DataSet
Using connection As New SqlConnection(connectionString)
Dim adapter As New SqlDataAdapter()
adapter.SelectCommand = New SqlCommand( _
queryString, connection)
adapter.Fill(dataSet)
Return dataSet
End Using
End Function
注釈
SqlDataAdapterは、データを取得して保存するためのDataSetと SQL Server の間のブリッジとして機能します。
SqlDataAdapterは、Fillマッピングによってこのブリッジを提供します。このブリッジは、データ ソース内のデータと一致するようにDataSet内のデータを変更し、データ ソースに対して適切な Transact-SQL ステートメントを使用して、DataSet内のデータと一致するようにデータ ソース内のデータを変更するUpdateを提供します。 更新は行ごとに実行されます。 挿入、変更、削除された行ごとに、 Update メソッドによって、実行された変更の種類 (Insert、 Update、または Delete) が決定されます。 変更の種類に応じて、 Insert、 Update、または Delete コマンド テンプレートが実行され、変更された行がデータ ソースに反映されます。
SqlDataAdapterがDataSetに入力されると、返されたデータに必要なテーブルと列がまだ存在しない場合は作成されます。 ただし、 MissingSchemaAction プロパティが AddWithKey に設定されていない限り、主キー情報は暗黙的に作成されるスキーマには含まれません。 また、FillSchemaを使用してデータを入力する前に、主キー情報を含むDataSetのスキーマを作成SqlDataAdapterがあります。 詳細については、「 DataSet への既存の制約の追加」を参照してください。
SqlDataAdapter は、SQL Server データベースに接続するときのパフォーマンスを向上させるために、 SqlConnection と SqlCommand と組み合わせて使用されます。
注
SQL Server のストアド プロシージャで、DataAdapter を使用してデータを編集または削除する場合、ストアド プロシージャの定義に SET NOCOUNT ON は使用しないでください。 処理された行数がゼロとして返され、DataAdapter によってコンカレンシーの競合として解釈されてしまいます。 このイベントでDBConcurrencyExceptionがスローされます。
SqlDataAdapterには、データの読み込みと更新を容易にするために、SelectCommand、InsertCommand、DeleteCommand、UpdateCommand、およびTableMappingsプロパティも含まれています。
SqlDataAdapterのインスタンスが作成されると、読み取り/書き込みプロパティが初期値に設定されます。 これらの値の一覧については、 SqlDataAdapter コンストラクターを参照してください。
InsertCommand、DeleteCommand、およびUpdateCommandは、パラメーター メカニズムを介して変更されたすべての行の個々の値で自動的に入力される汎用テンプレートです。
Update上のデータ ソースに伝達するすべての列について、パラメーターをInsertCommand、UpdateCommand、またはDeleteCommandに追加する必要があります。
DbParameter オブジェクトの SourceColumn プロパティは、列の名前に設定する必要があります。 この設定は、パラメーターの値が手動で設定されていないが、現在処理されている行の特定の列から取得されることを示します。
注
InvalidOperationExceptionは、Fill メソッドが呼び出され、テーブルにクライアント コンピューターで使用できないユーザー定義型が含まれている場合に発生します。 詳細については、「 CLR ユーザー定義型」を参照してください。
コンストラクター
| 名前 | 説明 |
|---|---|
| SqlDataAdapter() |
SqlDataAdapter クラスの新しいインスタンスを初期化します。 |
| SqlDataAdapter(SqlCommand) |
指定したSqlCommandをSelectCommand プロパティとして使用して、SqlDataAdapter クラスの新しいインスタンスを初期化します。 |
| SqlDataAdapter(String, SqlConnection) |
SelectCommandとSqlConnection オブジェクトを使用して、SqlDataAdapter クラスの新しいインスタンスを初期化します。 |
| SqlDataAdapter(String, String) |
SelectCommandと接続文字列を使用して、SqlDataAdapter クラスの新しいインスタンスを初期化します。 |
フィールド
| 名前 | 説明 |
|---|---|
| DefaultSourceTableName |
テーブル マッピングに DataAdapter オブジェクトによって使用される既定の名前。 (継承元 DbDataAdapter) |
プロパティ
| 名前 | 説明 |
|---|---|
| AcceptChangesDuringFill |
Fill 操作の実行中にDataTableにDataRowが追加された後にAcceptChanges()が呼び出されるかどうかを示す値を取得または設定します。 (継承元 DataAdapter) |
| AcceptChangesDuringUpdate |
Update(DataSet)中にAcceptChanges()を呼び出すかどうかを取得または設定します。 (継承元 DataAdapter) |
| CanRaiseEvents |
コンポーネントがイベントを発生できるかどうかを示す値を取得します。 (継承元 Component) |
| Container |
IContainerを含むComponentを取得します。 (継承元 Component) |
| ContinueUpdateOnError |
行の更新中にエラーが発生したときに例外を生成するかどうかを指定する値を取得または設定します。 (継承元 DataAdapter) |
| DeleteCommand |
データ セットからレコードを削除する Transact-SQL ステートメントまたはストアド プロシージャを取得または設定します。 |
| DesignMode |
Componentが現在デザイン モードであるかどうかを示す値を取得します。 (継承元 Component) |
| Events |
この Componentにアタッチされているイベント ハンドラーの一覧を取得します。 (継承元 Component) |
| FillCommandBehavior |
データ アダプターの入力に使用するコマンドの動作を取得または設定します。 (継承元 DbDataAdapter) |
| FillLoadOption |
アダプターがDbDataReaderからDataTableを塗りつぶす方法を決定するLoadOptionを取得または設定します。 (継承元 DataAdapter) |
| InsertCommand |
データ ソースに新しいレコードを挿入する Transact-SQL ステートメントまたはストアド プロシージャを取得または設定します。 |
| MissingMappingAction |
受信データに一致するテーブルまたは列がない場合に実行するアクションを決定します。 (継承元 DataAdapter) |
| MissingSchemaAction |
既存の DataSet スキーマが受信データと一致しない場合に実行するアクションを決定します。 (継承元 DataAdapter) |
| ReturnProviderSpecificTypes |
|
| SelectCommand |
データ ソース内のレコードを選択するために使用する Transact-SQL ステートメントまたはストアド プロシージャを取得または設定します。 |
| Site | (継承元 Component) |
| TableMappings |
ソース テーブルと DataTableの間のプライマリ マッピングを提供するコレクションを取得します。 (継承元 DataAdapter) |
| UpdateBatchSize |
サーバーへの各ラウンド トリップで処理される行数を取得または設定します。 |
| UpdateCommand |
データ ソース内のレコードを更新するために使用する Transact-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を参照してください。 |
