SqlDataAdapter クラス

.NET Framework クラス ライブラリ リファレンス

SqlDataAdapter クラス

DataSet へのデータの格納および SQL Server データベースの更新に使用される、一連のデータ コマンドおよびデータベース接続を表します。このクラスは継承できません。

名前空間: System.Data.SqlClient
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 SqlDataAdapter
    Inherits DbDataAdapter
    Implements IDbDataAdapter, IDataAdapter, ICloneable

Visual Basic (使用法)

Dim instance As SqlDataAdapter

C#

public sealed class SqlDataAdapter : DbDataAdapter,
 IDbDataAdapter, IDataAdapter, ICloneable

C++

public ref class SqlDataAdapter sealed : public
 DbDataAdapter, IDbDataAdapter, IDataAdapter, ICloneable

J#

public final class SqlDataAdapter extends DbDataAdapter
 implements IDbDataAdapter, IDataAdapter, 
    ICloneable

JScript

public final class SqlDataAdapter extends
 DbDataAdapter implements IDbDataAdapter, IDataAdapter, 
    ICloneable

解説

SqlDataAdapter は、DataSet と SQL Server の間でデータを取得および保存するための、ブリッジの役割を果たします。SqlDataAdapter は、このブリッジを提供するために、データ ソースに対して適切な Transact-SQL ステートメントを使用して、DataSet 内のデータをデータ ソース内のデータと一致するように変更する Fill と、データ ソース内のデータを DataSet 内のデータと一致するように変更する Update で、割り当てを行います。

SqlDataAdapter は、DataSet にデータを読み込むときに、返されたデータを格納するテーブルおよび列が存在しない場合は、それらを作成します。ただし、MissingSchemaAction プロパティを AddWithKey に設定しない限り、暗黙的に作成されたスキーマには主キー情報は設定されません。DataSet にデータを格納する前に、FillSchema を使用して、主キー情報を含むスキーマを SqlDataAdapter に作成させることもできます。詳細については、「DataSet への既存の制約の追加」を参照してください。

SqlDataAdapter は、SQL Server データベースへの接続のパフォーマンスを向上させるために、SqlConnection および SqlCommand と組み合わせて使用します。

SqlDataAdapter には、データの読み込みと更新を効率的に行うために、SelectCommand、InsertCommand、DeleteCommand、UpdateCommand、TableMappings の各プロパティも用意されています。

SqlDataAdapter のインスタンスを作成すると、読み書き可能プロパティが初期値に設定されます。これらの初期値の一覧については、SqlDataAdapter コンストラクタのトピックを参照してください。

Topic	Location
チュートリアル : TreeView コントロールでの階層データの表示	Visual Studio での ASP .NET Web アプリケーションの作成

使用例

SqlCommand、SqlDataAdapter、および SqlConnection を使用して、データベースからレコードを選択し、選択した行を DataSet に格納する例を次に示します。次に、格納された DataSet が返されます。そのために、初期化された DataSet、接続文字列、および Transact-SQL SELECT ステートメントのクエリ文字列がメソッドに渡されます。

Visual Basic

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

C#

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;
    }
}

継承階層

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Data.Common.DataAdapter
         System.Data.Common.DbDataAdapter
          System.Data.SqlClient.SqlDataAdapter

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
SqlDataAdapter メンバ
System.Data.SqlClient 名前空間
その他の技術情報
ADO.NET でのデータの変更
ADO.NET でのデータへの接続およびデータの取得
.NET Framework Data Provider for SQL Server の使用