SqlCeDataAdapter クラスとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

SqlCeDataAdapter クラス

DataSet へのデータの格納およびデータソースの更新に使用される、一連のデータコマンドおよびデータベース接続を表します。

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

Visual Basic (宣言)

Public NotInheritable Class
 SqlCeDataAdapter
    Inherits DbDataAdapter
    Implements ICloneable

Visual Basic (使用法)

Dim instance As SqlCeDataAdapter

public sealed class SqlCeDataAdapter : DbDataAdapter,
 ICloneable

C++

public ref class SqlCeDataAdapter sealed :
 public DbDataAdapter, ICloneable

public final class SqlCeDataAdapter extends
 DbDataAdapter implements ICloneable

JScript

public final class SqlCeDataAdapter extends
 DbDataAdapter implements ICloneable

解説

SqlCeDataAdapter は DataSet とデータソースの間のブリッジとして機能します。データソースからのデータ取得や、データソースへのデータ保存に使用されます。SqlCeDataAdapter は、このブリッジを提供するために、データソース内のデータを DataSet に読み込む Fill、および DataSet での変更をデータソースに送り返す Update を使用します。

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

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

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

使用例

SqlCeCommand、SqlCeDataAdapter、および SqlCeConnection を使用して、データソースからレコードを選択し、選択した行を DataSet に格納する例を次に示します。次に、格納された DataSet が返されます。このメソッドには、初期化済みの DataSet、接続文字列、および SQL SELECT ステートメントのクエリ文字列が渡されます。

Visual Basic

Dim conn As New SqlCeConnection("Data
 Source = AdventureWorks.sdf")

Dim selectCmd As SqlCeCommand = conn.CreateCommand()
selectCmd.CommandText = "SELECT * FROM DimEmployee"

Dim adp As New SqlCeDataAdapter(selectCmd)

Dim ds As New DataSet()

' Note: Fill will leave the connection in its original state;
' In this case, the connection was closed so it will be left closed
'
adp.Fill(ds)

SqlCeConnection conn = new SqlCeConnection("Data Source =
 AdventureWorks.sdf");

SqlCeCommand selectCmd = conn.CreateCommand();
selectCmd.CommandText = "SELECT * FROM DimEmployee";

SqlCeDataAdapter adp = new SqlCeDataAdapter(selectCmd);

DataSet ds = new DataSet();

// Note: Fill will leave the connection in its original state;
// In this case, the connection was closed so it will be left closed
//
adp.Fill(ds);

継承階層

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Data.Common.DataAdapter
         System.Data.Common.DbDataAdapter
          System.Data.SqlServerCe.SqlCeDataAdapter

スレッドセーフ

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

プラットフォーム

Windows CE, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows XP Professional x64 Edition, Windows XP SP2