SADataAdapter オブジェクトを使用したデータおよびスキーマ情報へのアクセス

SADataAdapter を使用すると、Fill メソッドを使用して DataTable を表示グリッドにバインドすることによってクエリの結果を DataTable に設定し、結果セット全体を表示できます。

SADataAdapter を使用すると、結果セットを返す文字列 (SQL 文またはストアドプロシージャー) を渡すことができます。SADataAdapter を使用する場合、前方専用、読み込み専用のカーソルを使用してすべてのローが 1 回のオペレーションでフェッチされます。結果セット内のすべてのローが読み込まれると、カーソルは閉じます。SADataAdapter を使用すると、DataTable を変更できます。変更が完了したら、データベースに再接続して変更を適用してください。

SADataAdapter オブジェクトを使用して、ジョインに基づく結果セットを取り出すことができます。ただし、変更 (挿入、更新、または削除) を行うことができるのは、単一テーブルのデータのみです。ジョインに基づく結果セットは更新できません。

警告

DataTable を変更できるのは、データベースへの接続が切断されている場合のみです。つまり、データベース内のこれらのローはアプリケーションによってロックされません。DataTable の変更がデータベースに適用されるときに発生する可能性がある競合を解消できるようアプリケーションを設計してください。これは、自分の変更がデータベースに適用される前に自分が修正しているデータを別のユーザーが変更しようとするような場合です。

DataTable を使用した C# の SADataAdapter Fill の例

次の例は、SADataAdapter を使用して DataTable を設定する方法を示します。Results という新しい DataTable オブジェクトと、新しい SADataAdapter オブジェクトを作成します。SADataAdapter の Fill メソッドを使用して、クエリの結果を DataTable に設定します。そして、DataTable を画面上のグリッドにバインドします。

SAConnection conn = new SAConnection( "Data Source=SQL Anywhere 12 Demo" );
conn.Open();
DataTable dt = new DataTable("Results");
SADataAdapter da = new SADataAdapter("SELECT * FROM Employees", conn);
da.Fill(dt);
conn.Close();
dataGridView1.DataSource = dt;

DataSet を使用した C# の SADataAdapter Fill の例

次の例は、SADataAdapter を使用して DataTable を設定する方法を示します。新しい DataSet オブジェクトと、新しい SADataAdapter オブジェクトを作成します。SADataAdapter の Fill メソッドを使用して、Results という DataTable テーブルを DataSet 内に作成した後、クエリの結果を設定します。そして、Results DataTable を画面上のグリッドにバインドします。

SAConnection conn = new SAConnection( "Data Source=SQL Anywhere 12 Demo" );
conn.Open();
DataSet ds = new DataSet();
SADataAdapter da = new SADataAdapter("SELECT * FROM Employees", conn);
da.Fill(ds, "Results");
conn.Close();
dataGridView1.DataSource = ds.Tables["Results"];

DataTable を使用した C# の SADataAdapter FillSchema の例

次の例は、FillSchema メソッドを使用して結果セットと同じスキーマを持つ新しい DataTable オブジェクトを設定する方法を示します。そして、Additions DataTable を画面上のグリッドにバインドします。

SAConnection conn = new SAConnection( "Data Source=SQL Anywhere 12 Demo" );
conn.Open();
SADataAdapter da = new SADataAdapter("SELECT * FROM Employees", conn);
DataTable schema = new DataTable("Additions");
da.FillSchema(schema, SchemaType.Source);
conn.Close();
dataGridView1.DataSource = schema;

DataSet を使用した C# の SADataAdapter FillSchema の例

次の例は、FillSchema メソッドを使用して結果セットと同じスキーマを持つ新しい DataTable オブジェクトを設定する方法を示します。Merge メソッドを使用して DataTable を DataSet に追加します。そして、Additions DataTable を画面上のグリッドにバインドします。

SAConnection conn = new SAConnection( "Data Source=SQL Anywhere 12 Demo" );
conn.Open();
SADataAdapter da = new SADataAdapter("SELECT * FROM Employees", conn);
DataTable schema = new DataTable("Additions");
da.FillSchema(schema, SchemaType.Source);
DataSet ds = new DataSet();
ds.Merge(schema);
conn.Close();
dataGridView1.DataSource = ds.Tables["Additions"];

参照

DocCommentXchange で意見交換できます