ファイル操作

Transcription

1 データセット DataSet クラス データのメモリ内キャッシュを表す 名前空間 :System.Data アセンブリ :System.Data(system.data.dll 内 ) 解説 データソースから取得されたデータのメモリ内キャッシュで有る DataSet は ADO.NET アーキテクチャの主要コンポーネントで有る DataSet は DataRelation オブジェクトと相互に関連付ける事が出来る DataTable オブジェクトのコレクションで構成される UniqueConstraint オブジェクトと ForeignKeyConstraint オブジェクトを使用して DataSet 内でデータの整合性を適用する事も出来る DataSet オブジェクトの使用の詳細に付いては ADO.NET での DataSet の使用 を参照され度い DataTable オブジェクトにはデータを格納出来るのに対して DataRelationCollection を使用するとテーブルの階層構造内を移動出来る テーブルは Tables プロパティを使用してアクセス出来る DataTableCollection に格納される DataTable オブジェクトにアクセスする時は 条件付きで大文字と小文字が区別される事に注意され度い 例えば mydatatable と謂う名前の DataTable と Mydatatable と謂う名前のテーブルが有る場合は 此の 2 つのーブルの孰れかを検索する文字列は大文字と小文字を区別すると看做される 但し mydatatable と謂う名前は存在するが Mydatatable と謂う名前が存在しない場合は 検索文字列は大文字と小文字を区別しないと看做される DataTable オブジェクトの使用の詳細に付いては DataTable の作成 を参照され度い DataSet では データとスキーマを XML ドキュメントとして読み取ったり 書き込んだり出来る 読み込んだデータとスキーマは HTTP で転送出来 XML 対応の総てのプラットフォーム 及び アプリケーションで使用出来る スキーマを XML スキーマと仕て保存するには WriteXmlSchema メソッドを使用する スキーマとデータの両方を保存するには WriteXml メソッドを使用する スキーマとデータの両方を含む XML ドキュメントを読み取るには ReadXml メソッドを使用する 通常の多階層の実装で DataSet を作成 更新し 次に元のデータを更新するステップを次に示す 1.DataAdapter を使用して DataSet 内に DataTable を作成し 各テーブルにデータソースのデータを格納する 2.DataRow オブジェクトを追加 更新 又は 削除して 個別の DataTable オブジェクト内のデータを変更する 3.GetChanges メソッドを呼び出して データへの変更丈を格納する 2 つ目の DataSet を作成する 4. 此の 2 つ目の DataSet を引数と仕て渡して DataAdapter の Update メソッドを呼び出す 5.Merge を呼び出して 2 つ目の DataSet に格納された変更を最初のデータセットにマージする 6.DataSet で AcceptChanges を呼び出す 変更をキャンセルするには RejectChanges を呼び出す -1-

2 パブリックプロパティ 名前 説明 CaseSensitive DataTable オブジェクト内の文字列比較で大文字と小文字を区別するか 何うかを示す値を取得 設定する Container コンポーネントを格納するコンテナを取得する DataSetName 現在の DataSet の名前を取得 設定する DefaultViewManager カスタム DataViewManager を使用してフィルタ処理 検索 移動の各 操作を行う事が出来る DataSet に格納されて居るデータのカスタムビ ューを取得する DesignMode コンポーネントが現在デザインモードか何うかを示す値を取得する EnforceConstraints 更新操作を試みた時に操作が制約規則に従って居るか何うかを示す値 を取得 設定する ExtendedProperties DataSet に関連付けられて居るカスタマイズされたユーザー情報のコレ クションを取得する HasErrors 此の DataSet 内の DataTable オブジェクトの孰れかにエラーが有るか 何うかを示す値を取得する IsInitialized DataSet が初期化されて居るか何うかを示す値を取得する Locale テーブル内の文字列の比較に使用するロケール情報を取得 設定する Namespace DataSet の名前空間を取得 設定する Prefix DataSet の名前空間に別名を付ける XML プリフィックスを取得 設定 する Relations テーブルをリンクし 親テーブルから子テーブルへ移動出来る様にする リレーションシップのコレクションを取得する RemotingFormat リモート処理中に使用される DataSet の SerializationFormat を取得 設定する SchemaSerializationMode DataSet の SchemaSerializationMode を取得 設定する Site DataSet の System.ComponentModel.ISite を取得 設定する Tables DataSet に格納されて居るテーブルのコレクションを取得する プロテクトプロパティ Events 名前 説明コンポーネントに結び付けられて居るイベントハンドラのリストを取得する パブリックメソッド 名前 AcceptChanges BeginInit Clear Clone Copy CreateDataReader Dispose 説明此の DataSet の読み込み 又は 前回の AcceptChanges の呼出以降に此のデータセットに対して行われた総ての変更をコミットする フォームや別のコンポーネントで使用する DataSet の初期化を開始する ( 初期化は実行時に発生する ) 総てのテーブル内の総ての行を削除して データの DataSet を消去する 総ての DataTable スキーマ リレーションシップ 及び 制約を含め DataSet の構造体をコピーする ( データのコピーは行わない ) 此の DataSet の構造体丈でなくデータもコピーする DataTable 毎に 1 つの結果セットを含む DataTableReader を返す ( 順序は Tables コレクション内のテーブルでの出現順序と同じで有る ) MarshalByValueComponent に依って使用されて居るリソースを解放する -2-

3 EndInit Equals GetChanges GetDataSetSchema GetHashCode GetObjectData GetService GetType GetXml GetXmlSchema HasChanges InferXmlSchema Load Merge ReadXml ReadXmlSchema ReferenceEquals RejectChanges Reset ToString WriteXml WriteXmlSchema フォーム又は別のコンポーネントで使用する DataSet の初期化を終了する ( 初期化は実行時に発生する ) 2 つの Object インスタンスが等しいか何うかを判断する 前回 DataSet を読み取るか AcceptChanges を呼び出した以降に此のデータセットに対して行われた総ての変更が格納されて居る此のデータセットのコピーを取得する 特定の型のハッシュ関数と仕て機能する GetHashCode は ハッシュアルゴリズムや ハッシュテーブルの様なデータ構造での使用に適して居る DataSet をシリアル化する為に必要なデータをシリアル化情報オブジェクトに設定する IServiceProvider を実装して居るオブジェクトを取得する 現在のインスタンスの Type を取得する DataSet に格納されて居るデータの XML 表現を返す DataSet に格納されて居るデータの XML 表現の XML スキーマを返す DataSet に新しい行 削除された行 変更された行等の変更が有るか何うかを示す値を取得する XML スキーマを DataSet に適用する 指定された IDataReader を使用し DataSet にデータソースからの値を設定する 指定した DataSet か DataTable 又は DataRow オブジェクトの配列を現在の DataSet 又は DataTable にマージする XML スキーマとデータを DataSet に読み込む XML スキーマを DataSet に読み込む 指定した複数の Object インスタンスが同一か何うかを判断する 此の DataSet を作成するか 前回 DataSet.AcceptChanges を呼び出した以降に此のデータセットに対して行われた総ての変更をロールバックする DataSet を元の状態にリセットする ( サブクラスが Reset をオーバーライドして DataSet を元の状態に戻す必要が有る ) Component の名前を格納して居る String を返す 此のメソッドはオーバーライド出来ません (MarshalByValueComponent から継承される ) DataSet から XML データを書き込む オプションでスキーマも書き込む事が出来る DataSet 構造体を XML スキーマと仕て書き込む プロテクトメソッド 名前説明 DetermineSchemaSerializationMode DataSet の SchemaSerializationMode を判別する Dispose MarshalByValueComponent に依って使用されて居るリソースを解放する (MarshalByValueComponent から継承される ) Finalize [To be supplied.] (MarshalByValueComponent から継承される ) GetSchemaSerializable GetSerializationData InitializeDerivedDataSet IsBinarySerialized MemberwiseClone 現在の Object の簡易コピーを作成する (Object から継承される ) -3-

4 OnPropertyChanging OnRemoveRelation OnRemoveTable RaisePropertyChanging ReadXmlSerializable ShouldSerializeRelations ShouldSerializeTables OnPropertyChanging イベントを発生させます DataTable から DataRelation オブジェクトが削除された時に発生する DataSet から DataTable が削除された時に発生する 指定した DataSet プロパティが此れから変更されると謂う通知を送信する Relations プロパティを永続化する必要が有るか何うかを示す値を取得する Tables プロパティを永続化する必要が有るか何うかを示す値を取得する 使用例 幾つかのメソッドを組み合わせて DataSet を作成した後で Northwind データベースのデータを読み込む例を次に示す Option Explicit On Option Strict On Visual basic Imports System.Data Imports system.data.sqlclient Public Class NorthwindDataSet Public Shared Sub Main() Dim connectionstring As String = GetConnectionString( ) ConnectToData(connectionString) End Sub Private Shared Sub ConnectToData( ByVal connectionstring As String) ' Create a SqlConnection to the Northwind database. Using connection As SqlConnection = New SqlConnection( connectionstring) ' Create a SqlDataAdapter for the Suppliers table. Dim suppliersadapter As SqlDataAdapter = New SqlDataAdapter( ) ' A table mapping names the DataTable. suppliersadapter.tablemappings.add("table", "Suppliers") ' Open the connection. connection.open( ) Console.WriteLine("The SqlConnection is open.") ' Create a SqlCommand to retrieve Suppliers data. Dim supplierscommand As SqlCommand = New SqlCommand( _ "SELECT SupplierID, CompanyName FROM dbo.suppliers;", connection) supplierscommand.commandtype = CommandType.Text ' Set the SqlDataAdapter's SelectCommand. suppliersadapter.selectcommand = supplierscommand ' Fill the DataSet. Dim dataset As DataSet = New DataSet("Suppliers") suppliersadapter.fill(dataset) -4-

5 ' Create a second SqlDataAdapter and SqlCommand to get ' the Products table, a child table of Suppliers. Dim productsadapter As SqlDataAdapter = New SqlDataAdapter( ) productsadapter.tablemappings.add("table", "Products") Dim productscommand As SqlCommand = New SqlCommand( _ "SELECT ProductID, SupplierID FROM dbo.products;", connection) productsadapter.selectcommand = productscommand ' Fill the DataSet. productsadapter.fill(dataset) ' Close the connection. connection.close( ) Console.WriteLine("The SqlConnection is closed.") ' Create a DataRelation to link the two tables based on the SupplierID. Dim parentcolumn As DataColumn = _ dataset.tables("suppliers").columns("supplierid") Dim childcolumn As DataColumn = _ dataset.tables("products").columns("supplierid") Dim relation As DataRelation = New _ System.Data.DataRelation("SuppliersProducts", parentcolumn, childcolumn) dataset.relations.add(relation) Console.WriteLine( "The 0 DataRelation has been created.", relation.relationname) End Using End Sub Private Shared Function GetConnectionString( ) As String ' To avoid storing the connection string in your code, ' you can retrieve it from a configuration file. Return "Data Source=(local);Initial Catalog=Northwind; Integrated Security=SSPI;" End Function End Class using System; using System.Data; using System.Data.SqlClient; namespace Microsoft.AdoNet.DataSetDemo class NorthwindDataSet static void Main( ) string connectionstring = GetConnectionString( ); ConnectToData(connectionString); private static void ConnectToData(string connectionstring) //Create a SqlConnection to the Northwind database. using (SqlConnection connection = new SqlConnection(connectionString)) -5-

6 //Create a SqlDataAdapter for the Suppliers table. SqlDataAdapter adapter = new SqlDataAdapter( ); // A table mapping names the DataTable. adapter.tablemappings.add("table", "Suppliers"); // Open the connection. connection.open( ); Console.WriteLine("The SqlConnection is open."); // Create a SqlCommand to retrieve Suppliers data. SqlCommand command = new SqlCommand( "SELECT SupplierID, CompanyName FROM dbo.suppliers;",connection); command.commandtype = CommandType.Text; // Set the SqlDataAdapter's SelectCommand. adapter.selectcommand = command; // Fill the DataSet. DataSet dataset = new DataSet("Suppliers"); adapter.fill(dataset); // Create a second Adapter and Command to get // the Products table, a child table of Suppliers. SqlDataAdapter productsadapter = new SqlDataAdapter( ); productsadapter.tablemappings.add("table", "Products"); SqlCommand productscommand = new SqlCommand( "SELECT ProductID, SupplierID FROM dbo.products;",connection); productsadapter.selectcommand = productscommand; // Fill the DataSet. productsadapter.fill(dataset); // Close the connection. connection.close( ); Console.WriteLine("The SqlConnection is closed."); // Create a DataRelation to link the two tables based on the SupplierID. DataColumn parentcolumn = dataset.tables["suppliers"].columns["supplierid"]; DataColumn childcolumn = dataset.tables["products"].columns["supplierid"]; DataRelation relation = new System.Data.DataRelation("SuppliersProducts", parentcolumn, childcolumn); dataset.relations.add(relation); Console.WriteLine("The 0 DataRelation has been created.",relation.relationname); static private string GetConnectionString( ) // To avoid storing the connection string in your code, // you can retrieve it from a configuration file. return "Data Source=(local);Initial Catalog=Northwind; Integrated Security=SSPI"; -6-

7 DataSet クラスの概要 DataSet オブジェクトは ADO.NET で非接続型分散データシナリオをサポートする上で中心的な役割を果たす DataSet は メモリ内に常駐するデータ表現で有り データソースの違いに拘らず 一貫性の有るリレーショナルプログラミングモデルを提供する 複数の異なるデータソースや XML データと組み合わせて使用出来 アプリケーションに取ってローカルなデータの管理にも使用出来る DataSet は 関連テーブル 制約 及び テーブル間のリレーションシップを含む完全なデータセットを表現する 次の図に示すのが DataSet オブジェクトモデルで有る DataSet オブジェクトモデル 1 つの DataSet に含まれるメソッドとオブジェクトは リレーショナルデータベースモデルに含まれるメソッドやオブジェクトと整合性が有る DataSet は 其の内容を XML と仕て永続化 及び 再読み込みしたり 其のスキーマを XML スキーマ定義言語 (XSD) スキーマと仕て永続化 及び 再読み込みしたり出来る 詳細に付いては DataSet での XML の使用 を参照され度い DataTableCollection ADO.NET の DataSet には DataTable オブジェクトに依って表現される 0 個以上のテーブルのコレクションが含まれる DataTableCollection には 1 つの DataSet に属する総ての DataTable オブジェクトが含まれて居る DataTable は System.Data 名前空間で定義され メモリ常駐データの 1 つのテーブルを表現する 此のテーブルには 共にテーブルのスキーマを定義する DataColumnCollection で表現される列と ConstraintCollection で表現される制約のコレクションが含まれる DataTable には テーブル内のデータが格納された DataRowCollection で表現される行のコレクションも含まれる DataRow には 行に格納された値の変更を識別出来る様に 行の現在の状態と共に 行の現在のバージョンと元のバージョンの両方が保持される -7-

8 DataRelationCollection DataSet の DataRelationCollection オブジェクトにはリレーションシップが含まれる DataRelation オブジェクトで表現されるリレーションシップは 或る DataTable の行を別の DataTable の行に関連付ける リレーションシップは リレーショナルデータベースの主キー列と外部キー列の間に存在する結合パスに似て居る DataRelation は 1 つの DataSet が含む 2 つのテーブルの間で 一致する列を識別する リレーションシップを使用すると DataSet 内部の 或るテーブルと別のテーブルを行き来する事が出来る DataRelation で必須とされる要素は リレーションシップの名前 関連付けるテーブルの名前 及び 各テーブル内で関連付けられる列で有る DataColumn オブジェクトの配列をキー列と仕て指定する事に依って テーブル毎に複数の列を使用してリレーションシップを構築出来る DataRelationCollection にリレーションシップを追加する時は 関連列の値が変更された時に整合性制約を適用する為に オプションで UniqueKeyConstraint 及び ForeignKeyConstraint を追加出来る ExtendedProperties DataSet DataTable 及び DataColumn には 総て ExtendedProperties プロパティが有る ExtendedProperties は PropertyCollection で有り 此処には 結果セットの生成に使われた SELECT ステートメントやデータが生成された時刻等 独自の情報を格納出来る ExtendedProperties コレクションは DataSet のスキーマ情報と共に永続化される DataSet の作成 DataSet のインスタンスを作成するには DataSet のコンストラクタを呼び出す 必要に応じて 引数 name を指定する 名前を指定しない場合 DataSet の名前は NewDataSet に設定される 亦 既存の DataSet に基づいて新しい DataSet を作成する事も出来る 既存の DataSet の正確なコピーを新しい DataSet と仕て作成出来るのは リレーショナル構造やスキーマはコピーするけれども既存の DataSet からのデータは含まない DataSet のクローン 又は GetChanges メソッドを使用して既存の DataSet から変更された行丈を含む DataSet のサブセットの孰れかで有る 詳細に付いては DataSet の内容のコピー を参照され度い DataSet のインスタンスの作成方法を示すコード例を次に示す Dim customerorders As DataSet = New DataSet("CustomerOrders") DataSet customerorders = new DataSet("CustomerOrders"); DataSet への DataTable の追加 ADO.NET を使用して DataTable オブジェクトを作成し 其のオブジェクトを既存の DataSet に追加出来る PrimaryKey プロパティと Unique プロパティを使用する事で DataTable の制約情報を設定出来る 例 DataSet を構築し DataSet に新しい DataTable オブジェクトを追加してから 3 つの DataColumn オブジェクトを其のテーブルに追加する例を次に示す コードの最後では 1 つの列が主キーの列と仕て設定されて居る -8-

9 大文字と小文字の区別 大文字と小文字の区別が異なれば DataSet に存在する 2 つ以上のテーブルやリレーションが同じ名前を持つ事が出来る 此の場合 名前を使用してテーブルとリレーションを参照する際に大文字と小文字が区別される 例えば DataSet dataset に Table1 と table1 のテーブルが有る場合 Table1 を参照するには dataset.tables["table1"] table1 を参照するには dataset.tables ["table1"] と名前を指定する 此の孰れかのテーブルの参照に dataset.tables ["TABLE1"] と指定すると 例外が発生する 特定の名前を持つテーブルやリレーションが 1 つ而巳の場合 大文字と小文字は区別されない 例えば DataSet に Table1 しか存在しない場合は dataset.tables["table1"] を使用して其のテーブルを参照出来る メモ : 此の動作は DataSet の CaseSensitive プロパティの影響を受けない CaseSensitive プロパティは DataSet 内のデータに適用され 並替 検索 フィルタ処理 制約の適用等に影響を及ぼす 名前空間のサポート 以前のバージョンの ADO.NET では 異なる名前空間に存在して居るテーブルで有っても 2 つのテーブルが同じ名前を持つ事は出来なかった ADO.NET 2.0 には 此の制限は無い 従って DataSet に Namespace プロパティ値が異なり TableName プロパティ値が一致する 2 つのテーブルが存在しても問題無い テーブル間のリレーションシップの追加 複数の DataTable オブジェクトを含む DataSet では DataRelation オブジェクトを使用して 1 つのテーブルを別のテーブルに関連付けたり テーブル間を移動したり 関連付けたテーブルから子や親の行を戻したり出来る DataRelation の作成に必要な引数は 作成する DataRelation の名前 及び 其のリレーションシップで親子の列と成る列への 1 つ以上の DataColumn 参照の配列で有る DataRelation の作成後 DataRelation を使用してテーブル間の移動や値の取得を行う事が出来る DataSet への DataRelation の追加は 既定では UniqueConstraint が親テーブルに ForeignKeyConstraint が子テーブルに追加される 上記の既定の制約の詳細に付いては テーブルへの制約の追加 を参照され度い DataSet に有る 2 つの DataTable オブジェクトを使用して DataRelation を作成するコード例を次に示す 各 DataTable には 2 つの DataTable オブジェクト間のリンクと成る CustID と謂う名前の列が有る 例では 単一の DataRelation が DataSet の Relations コレクションに追加される 例に有る最初の引数には 作成する DataRelation の名前を指定する 2 番目の引数に依って親の DataColumn が 3 番目の引数に依って子の DataColumn が設定される customerorders.relations.add("custorders", _ customerorders.tables("customers").columns("custid"), _ customerorders.tables("orders").columns("custid")) customerorders.relations.add("custorders", customerorders.tables["customers"].columns["custid"], customerorders.tables["orders"].columns["custid"]); DataRelation には 入れ子に成ったプロパティも有る true に設定すると WriteXml を使用して XML 要素と仕て書き込む時に 親テーブルの関連付けられた行の中で子テーブルの行が入れ子に成る 詳細に付いては DataSet での XML の使用 を参照され度い -9-

10 テーブル間のリレーションシップの移動 DataRelation の主な機能の 1 つは DataSet の 1 つの DataTable から別の DataTable を移動出来る事で有る 此の参照に依り 関連付けられた DataTable から単一の DataRow を指定すると 1 つの DataTable 内の関連する DataRow オブジェクトを総て取得出来る 例えば 顧客のテーブルとオーダーのテーブル間に DataRelation を確立すると GetChildRows を使用して特定の顧客行のオーダー行を総て取得出来る DataSet の Customers テーブルと Orders テーブル間の DataRelation を作成し 各顧客の総てのオーダーを返すコード例を次に示す 上記の例に基づいて 4 つのテーブルを相互に関連付け 其のテーブルのリレーションシップ間を移動する例を次に示す 上記の例に示す様に CustomerID は Customers テーブルを Orders テーブルに関連付ける Customers テーブルに有る各顧客に対しては Orders テーブルに有る総ての子の行が確定され 該当する顧客のオーダー数と其の OrderID の値が返される 展開された例では OrderDetails テーブルと Products テーブルからも値が返される 各顧客のオーダーに対しては オーダーされた製品と数量を示す為に OrderID を使用して Orders テーブルが OrderDetails テーブルに関連付けられる OrderDetails テーブルに含まれて居るのは オーダーされた製品の ProductID 丈で有る為 ProductID を使用して OrderDetails を Products に関連付けて ProductName を返す 此のリレーションでは Products テーブルが親と成り OrderDetails テーブルが子と成る 其の結果 OrderDetails テーブルを順次処理すると GetParentRow が呼び出され 関連付けられた ProductName の値を取得する DataRelation が Customers テーブルと Orders テーブルに対して作成された場合には createconstraints フラグには値が指定されない ( 既定値は true) 此れは Orders テーブルに有る総ての行に対して親の Customers テーブルに有る CustomerID の値が設定されて居る為で有る Orders テーブルに Customers テーブルに存在しない CustomerID が存在する場合 ForeignKeyConstraint は例外をスローする 親の列に含まれて居ない値が子の列に含まれる場合 DataRelation の追加時に createconstraints フラグが false に設定される 例では Orders テーブルと OrderDetails テーブル間の DataRelation に対して createconstraints フラグが false に設定されて居る 此の為 此のアプリケーションでは OrderDetails テーブルから総てのレコードを返し 実行時に例外を生成せずに Orders テーブルからレコードのサブセット丈を返す事が出来る 展開された例では 次の形式で出力が生成される Customer ID: NORTS Order ID: Order Date: 4/24/ :00:00 AM Product: Filo Mix Quantity: 6 Product: Raclette Courdavault Quantity: 4 Product: Outback Lager Quantity: 6 Order ID: Order Date: 4/29/ :00:00 AM Product: Outback Lager Quantity: 3 Orders テーブルのレコードのサブセット丈と共に OrderDetails テーブルと Products テーブルからの値が返された場合に展開された例を次のコード例に示す -10-

11 Dim customerordersrelation As DataRelation = _ customerorders.relations.add("custorders", _ customerorders.tables("customers").columns("customerid"), _ customerorders.tables("orders").columns("customerid")) Dim orderdetailrelation As DataRelation = _ customerorders.relations.add("orderdetail", _ customerorders.tables("orders").columns("orderid"), _ customerorders.tables("orderdetails").columns("orderid"), False) Dim orderproductrelation As DataRelation = _ customerorders.relations.add("orderproducts", _ customerorders.tables("products").columns("productid"), _ customerorders.tables("orderdetails").columns("productid")) Dim custrow, orderrow, detailrow As DataRow For Each custrow In customerorders.tables("customers").rows Console.WriteLine("Customer ID:" & custrow("customerid").tostring( )) For Each orderrow In custrow.getchildrows(customerordersrelation) Console.WriteLine("Order ID: " & orderrow("orderid").tostring( )) Console.WriteLine(vbTab & "Order Date: " & orderrow("orderdate").tostring( )) For Each detailrow In orderrow.getchildrows(orderdetailrelation) Console.WriteLine(vbTab & " Product: " & _ detailrow.getparentrow(orderproductrelation) ("ProductName").ToString( )) Console.WriteLine(vbTab & "Quantity: " & detailrow("quantity").tostring( )) Next Next Next DataRelation customerordersrelation = customerorders.relations.add("custorders", customerorders.tables["customers"].columns["customerid"], customerorders.tables["orders"].columns["customerid"]); DataRelation orderdetailrelation = customerorders.relations.add("orderdetail", customerorders.tables["orders"].columns["orderid"], customerorders.tables["orderdetails"].columns["orderid"], false); DataRelation orderproductrelation = customerorders.relations.add("orderproducts", customerorders.tables["products"].columns["productid"], customerorders.tables["orderdetails"].columns["productid"]); foreach (DataRow custrow in customerorders.tables["customers"].rows) Console.WriteLine("Customer ID: " + custrow["customerid"]); foreach (DataRow orderrow in custrow.getchildrows(customerordersrelation)) Console.WriteLine("Order ID: " + orderrow["orderid"]); Console.WriteLine(" torder Date: " + orderrow["orderdate"]); foreach (DataRow detailrow in orderrow.getchildrows(orderdetailrelation)) Console.WriteLine(" t Product: " + detailrow.getparentrow(orderproductrelation)["productname"]); Console.WriteLine(" t Quantity: " + detailrow["quantity"]); -11-

12 既存のデータを含む DataSet の使用 DataSet は データソースに依存しないデータに対するメモリ内のリレーショナル形式で有る 但し.NET Framework データプロバイダで使用する場合には DataSet はデータソース内の既存データと共に使用出来る.NET Framework データプロバイダでは DataAdapter を使用してデータソースのデータに加えた変更を解決する丈でなく DataSet にデータやスキーマの情報を格納する DataSet の読み込みや データソースのデータに加えた変更の解決の詳細に付いては 次の資料を参照され度い DataAdapter からの DataSet の読み込み 此の資料では データソースのデータを含む DataSet を読み込む方法に付いて説明する DataAdapter に依るデータソースの更新 此の資料では DataSet のデータに加えた変更を解決してデータソースに戻る方法に付いて説明する DataSet への既存の制約の追加 此の資料では データソースの主キー情報を含む DataSet を設定する方法に付いて説明する DataAdapter に依るパラメータの使用 及び パラメータと戻り値の指定 此等の資料では DataSet に有るテーブルの列をデータソースで実行されたコマンドの入力 及び 出力パラメータに関連付ける方法に付いて説明する DataSet では 既存の XML データの読み取りや書き込みを行う事も出来る 詳細に付いては DataSet での XML の使用 を参照され度い DataAdapter からの DataSet の読み込み ADO.NET の DataSet は データソースに依存しない一貫したリレーショナルプログラミングモデルを提供するメモリ常駐型のデータ表現で有る DataSet はテーブル 制約 及び テーブル間のリレーションシップを含む完全なデータのセットを表す DataSet はデータソースとは独立して居る為 DataSet には 其のアプリケーションに固有のデータと複数のデータソースからのデータを含める事が出来る 既存のデータソースとの対話は DataAdapter に依って制御される DataAdapter の SelectCommand プロパティは データソースからデータを取得する Command オブジェクトで有る DataAdapter の InsertCommand UpdateCommand DeleteCommand の各プロパティは DataSet のデータに対して行われた変更に基づいてデータソースのデータ更新を管理する Command オブジェクトで有る 此等のプロパティに付いては DataAdapter に依るデータソースの更新 で更に詳しく説明する DataAdapter の Fill メソッドは DataAdapter の SelectCommand の結果を使用して DataSet を設定する為に使用する Fill は 自らの引数と仕て 設定対象で有る DataSet と DataTable オブジェクト ( 詰まり SelectCommand が返した行を格納して居る DataTable の名前 ) を受け取る Fill メソッドは DataReader オブジェクトを暗黙的に使用して DataSet 内でテーブルを作成する為の列の名前と型 及び DataSet 内のテーブルの行を設定する為のデータを返す テーブルと列は 存在しない場合に丈作成される 既に存在する場合は Fill は既存の DataSet スキーマを使用する 列の型は.NET Framework データプロバイダのデータ型から.NET Framework のデータ型への変換 の表に基づき.NET Framework の型と仕て作成される データソースに主キーが存在し DataAdapter.MissingSchemaAction が MissingSchemaAction.AddWithKey に設定されて居る場合丈 主キーが作成されるが 其れ以外の場合は主キーは作成されない Fill はテーブルに主キーが有る事が解ると 主キー列の値がデータソースから返された主キー列の値と一致する行に付いて データソース -12-

13 から返されたデータで DataSet 内のデータを上書きする 主キーが見付からない場合は DataSet のテーブルの末尾にデータを追加する Fill は DataSet にデータを読み込む時に存在する総てのマッピングを使用する ( DataTable と DataColumn のマップの設定 を参照され度い ) メモ :SelectCommand が OUTER JOIN の結果を返す場合 DataAdapter は 生成される DataTable に PrimaryKey 値を設定しない 開発者が PrimaryKey を定義して 重複行が正しく解決される様にする必要が有る 詳細に付いては テーブルの主キーの定義 を参照され度い Microsoft SQL Server Northwind データベースへの SqlConnection を使用し DataSet 内の DataTable に顧客リストを読み込む SqlDataAdapter のインスタンスを作成するコード例を次に示す SqlDataAdapter コンストラクタに渡される SQL ステートメントと SqlConnection 引数は SqlDataAdapter の SelectCommand プロパティを作成する為に使用される ' Assumes that connection is a valid SqlConnection object. Dim querystring As String = "SELECT CustomerID, CompanyName FROM dbo.customers" Dim adapter As SqlDataAdapter = New SqlDataAdapter( querystring, connection) Dim customers As DataSet = New DataSet adapter.fill(customers, "Customers") // Assumes that connection is a valid SqlConnection object. string querystring = "SELECT CustomerID, CompanyName FROM dbo.customers"; SqlDataAdapter adapter = new SqlDataAdapter(queryString, connection); DataSet customers = new DataSet( ); adapter.fill(customers, "Customers"); メモ : 此のサンプルコードでは Connection の開始と終了を明示的に行って居ない Fill メソッドは 接続が未だ開いて居ない事を認識すると DataAdapter が使用して居る Connection を暗黙的に開く Fill が接続を開いた場合は Fill の終了時に Fill が接続を終了する 此れに依り Fill や Update 等の単一の操作を扱う場合にコードを簡略化出来る 此れに対し 開いて居る接続を必要とする複数の操作を実行する場合は Connection の Open メソッドを明示的に呼び出し データソースに対する操作の実行後に Connection の Close メソッドを呼び出す事でアプリケーションのパフォーマンスを改善出来る リソースを解放して他のクライアントアプリケーションが使用出来る様にする為に データソースへの接続を開いた儘にする時間は最小限にする事を推奨する 複数結果セット DataAdapter は複数の結果セットを検出すると DataSet に複数のテーブルを作成する 此等のテーブルには Table0 の様に Table で始まるインクリメンタル既定名 TableN が割り当てられる テーブル名を引数と仕て Fill メソッドに渡すと TableName0 を表す TableName で始まるインクリメンタル既定名 TableNameN が割り当てられる 複数の DataAdapter からの DataSet の読み込み 1 つの DataSet で 任意の数の DataAdapter オブジェクトを使用出来る 夫々れの DataAdapter で 1 つ以上の DataTable オブジェクトにデータを格納し 関連するデータソースに更新を反映させる事が出来る DataSet に対して DataRelation オブジェクトや Constraint オブジェクトを部分的に追加出来る為 開発者は複数の異なるデータソースから取得したデータを関連付ける事が出来る 例えば Microsoft SQL Server データベース OLE DB を通じて公開される IBM DB2 データベース 及び XML をストリーム転送するデータソースからのデータを DataSet に含める事が出来る 1 つ以上の DataAdapter オブジェクトを使用して 各データソースとの通信を行う事が出来る -13-

14 例 次のコード例では Microsoft SQL Server 2000 の Northwind データベースからの顧客リストと Microsoft Access 2000 に格納されて居る Northwind データベースからの注文リストを取得する データが格納されて居るテーブルが DataRelation に関連付けられ 顧客の一覧が各顧客の注文と共に表示される DataRelation オブジェクトの詳細に付いては テーブル間のリレーションシップの追加 及び テーブル間のリレーションシップの移動 を参照され度い ' Assumes that customerconnection is a valid SqlConnection object. ' Assumes that orderconnection is a valid OleDbConnection object. Dim custadapter As SqlDataAdapter = New SqlDataAdapter( _ "SELECT * FROM dbo.customers", customerconnection) Dim ordadapter As OleDbDataAdapter = New OleDbDataAdapter( _ "SELECT * FROM Orders", orderconnection) Dim customerorders As DataSet = New DataSet( ) custadapter.fill(customerorders, "Customers") ordadapter.fill(customerorders, "Orders") Dim relation As DataRelation = _ customerorders.relations.add("custorders", _ customerorders.tables("customers").columns("customerid"), _ customerorders.tables("orders").columns("customerid")) Dim prow, crow As DataRow For Each prow In customerorders.tables("customers").rows Console.WriteLine(pRow("CustomerID").ToString( )) For Each crow In prow.getchildrows(relation) Console.WriteLine(vbTab & crow("orderid").tostring( )) Next Next // Assumes that customerconnection is a valid SqlConnection object. // Assumes that orderconnection is a valid OleDbConnection object. SqlDataAdapter custadapter = new SqlDataAdapter( "SELECT * FROM dbo.customers", customerconnection); OleDbDataAdapter ordadapter = new OleDbDataAdapter( "SELECT * FROM Orders", orderconnection); DataSet customerorders = new DataSet( ); custadapter.fill(customerorders, "Customers"); ordadapter.fill(customerorders, "Orders"); DataRelation relation = customerorders.relations.add("custorders", customerorders.tables["customers"].columns["customerid"], customerorders.tables["orders"].columns["customerid"]); foreach (DataRow prow in customerorders.tables["customers"].rows) Console.WriteLine(pRow["CustomerID"]); foreach (DataRow crow in prow.getchildrows(relation)) Console.WriteLine(" t" + crow["orderid"]); -14-

15 SQL Server の 10 進数型 既定では DataSet は.NET Framework のデータ型を使用してデータを格納する 殆どのアプリケーションで 此等のデータ型を使用してデータソース情報を簡単に表示出来る 併し データソースのデータ型が SQL Server の 10 進数データ型や数値データ型の場合は 此の表現に依って問題が生じる場合が有る.NET Framework の decimal データ型の最大有効桁数は 28 桁で有るのに対し SQL Server の decimal データ型の有効桁数は 38 桁で有る Fill が動作して居る間に SqlDataAdapter が SQL Server の decimal フィールドの有効桁数が 28 文字を超えて居ると判断した場合 現在の行は DataTable に追加されない 其の場合は FillError イベントが発生する為 開発者は有効桁数の消失が発生して居ないか何うかを確認し 適切に対応出来る FillError イベントの詳細に付いては DataAdapter イベントの使用 を参照され度い SQL Server の decimal 値を取得するには SqlDataReader オブジェクトを使用し GetSqlDecimal メソッドを呼び出す事も出来る ADO.NET 2.0 では DataSet の System.Data.SqlTypes に対するサポート機能が強化されて居る 詳細に付いては SqlTypes と DataSet を参照され度い OLE DB のチャプタ 階層構造の行セット 詰まり チャプタ (OLE DB では DBTYPE_HCHAPTER 型 ADO では adchapter 型 ) を使用して DataSet の内容を格納出来る OleDbDataAdapter が Fill が動作して居る間にチャプタ列を検出すると 其のチャプタ列の為の DataTable を作成し チャプタから取得した列と行を此のテーブルに格納する チャプタ列用に作成されたテーブルには 親テーブルの名前とチャプタ列の名前の両方を使用した ParentTableNameChapteredColumnName 形式の名前が割り当てられる DataSet にチャプタ列の名前と一致するテーブルが既に存在する場合は 現在のテーブルにチャプタデータが格納される 既存のテーブルにチャプタ内の列と一致する列が存在しない場合は 新しい列が追加される DataSet 内のテーブルにチャプタ列のデータを格納する前に 親テーブルと子テーブルの両方に 1 つの整数列を追加し 親列を自動インクリメントに設定し 両方のテーブルに追加された列を使用して DataRelation を作成すると 階層構造の行セットを形成して居る親テーブルと子テーブルの間にリレーションが作成される 追加されたリレーションには親テーブルの名前とチャプタ列の名前を使用した ParentTableNameChapterColumnName 形式の名前が割り当てられる 関連付けられた列は DataSet 丈に存在する 其のデータソースからの次の Fill 操作を実行すると 変更を既存の行にマージするのではなく テーブルに新しい行が追加される DataTable を受け取る DataAdapter.Fill オーバーロードを使用した場合は 其のテーブル丈にデータが格納される 自動インクリメント整数列は 引き続き其のテーブルに追加されるが 子テーブルの作成 子テーブルへのデータの格納 及び リレーションの作成は行われない MSDataShape プロバイダを使用して顧客リスト内の各顧客に対応するオーダー列を生成する例を次に示す チャプタ列を生成した後で 1 つの DataSet 内に其のデータを格納する Using connection As OleDbConnection = New OleDbConnection( _ "Provider=MSDataShape;Data Provider=SQLOLEDB;" & _ "Data Source=(local);Integrated " & _ "Security=SSPI;Initial Catalog=northwind") Dim adapter As OleDbDataAdapter = New OleDbDataAdapter( _ "SHAPE SELECT CustomerID, CompanyName FROM Customers " & _ "APPEND (SELECT CustomerID, OrderID FROM Orders AS Orders " & _ "RELATE CustomerID TO CustomerID)", connection) -15-

16 Dim customers As DataSet = New DataSet( ) adapter.fill(customers, "Customers") End Using using (OleDbConnection connection = new OleDbConnection( "Provider=MSDataShape;Data Provider=SQLOLEDB;" + "Data Source=(local);Integrated Security=SSPI;Initial Catalog=northwind")) OleDbDataAdapter adapter = new OleDbDataAdapter( "SHAPE SELECT CustomerID, CompanyName FROM Customers " + "APPEND (SELECT CustomerID, OrderID FROM Orders AS Orders " + "RELATE CustomerID TO CustomerID)", connection); DataSet customers = new DataSet( ); adapter.fill(customers, "Customers"); Fill 操作が完了すると DataSet に Customers と CustomersOrders の 2 つのテーブルが格納される CustomersOrders はチャプタ列を表す Orders と謂う列が Customers テーブルに追加され CustomersOrders と謂う列が CustomersOrders テーブルに追加される Customers テーブルの Orders 列は 自動インクリメントに設定される 親テーブルで有る Customers テーブルに追加された列を使用して CustomersOrders と謂う DataRelation が作成される サンプル結果の一部を次の表に示す TableName:Customers CustomerID CompanyName Orders ALFKI Alfreds Futterkiste 0 ANATR Ana Trujillo Emparedados y helados 1 TableName:CustomersOrders CustomerID OrderID CustomersOrders ALFKI ALFKI ANATR ANATR DataAdapter に依るデータソースの更新 DataAdapter の Update メソッドを呼び出して 変更を DataSet からデータソースに反映する Update メソッドは Fill メソッドと同様に 引数と仕て DataSet のインスタンス 及び オプションの DataTable オブジェクト 又は DataTable 名を受け取る DataSet のインスタンスは 行われた変更点を格納する DataSet で有る DataTable は 変更点の取得元のテーブルで有る Update メソッドを呼び出すと DataAdapter は 既に加えられた変更を解析し 適切なコマンド (INSERT UPDATE 又は DELETE) を実行する DataAdapter は DataRow へ加えられた変更を検出すると InsertCommand UpdateCommand 又は DeleteCommand を使用して其の変更を処理する 其の結果 デザイン時にコマンド構文を指定し 可能な場合はストアドプロシージャを使用する事に依り ADO.NET アプリケーションのパフォーマンスを最適化出来る コマンドは Update を呼び出す前に明示的に設定する必要が有る Update を呼び出し 其の更新に関連する適切なコマンドが存在しない場合 ( 例えば 削除済みの行に関連する DeleteCommand が存在しない場合 ) は 例外がスローされる -16-

17 Command パラメータを使用して DataSet 内の各変更行に対する SQL ステートメントやストアドプロシージャに入力値と出力値を指定出来る 詳細に付いては DataAdapter に依るパラメータの使用 を参照され度い DataTable を単一データベーステーブルに割り当てたり 単一データベースから生成する場合は DbCommandBuilder オブジェクトを利用して自動的に DataAdapter の DeleteCommand InsertCommand 及び UpdateCommand を生成出来る 詳細に付いては コマンドの自動生成 を参照され度い Update メソッドは変更点を元のデータソースに反映させるが DataSet に最後にデータを格納した後 他のクライアントがデータソースのデータを変更した可能性も有る DataSet を現在のデータで更新するには DataAdapter と Fill メソッドを使用する 新しい行がテーブルに追加され 更新された情報が既存の行に取り込まれる Fill メソッドは DataSet の行と SelectCommand に依って返された行の主キーの値を調べて 新しい行が追加されたか 又は 既存の行が更新されたかを判断する Fill メソッドは SelectCommand に依って返された結果の行に一致する主キーの値を持つ DataSet の行を見付けた場合 SelectCommand に依って返された行の情報で既存の行を更新して 既存の行の RowState を Unchanged に設定する SelectCommand に依って返された行の主キーの値が DataSet の何の行の主キーの値にも一致しない場合 Fill メソッドは RowState が Unchanged の新しい行を追加する メモ :SelectCommand が OUTER JOIN の結果を返す場合 DataAdapter は 生成される DataTable に PrimaryKey 値を設定しない 自分で PrimaryKey を定義して 重複行が正しく反映される様にする必要が有る 詳細に付いては テーブルの主キーの定義 を参照され度い Update メソッド呼出時に発生する例外を処理するには 行更新エラーが発生した時に RowUpdated イベントを使用して応答するか ( DataAdapter イベントの使用 を参照 ) 又は Update メソッド呼出の前に DataAdapter.ContinueUpdateOnError を true に設定し 更新が完了した時点で特定の行の RowError プロパティに格納されて居るエラー情報に応答する ( 行のエラー情報の追加と読み取り を参照 ) メモ :DataSet DataTable 又は DataRow に対して AcceptChanges を呼び出すと DataRow の総ての Original 値が DataRow の Current 値で上書きされる 行を一意に識別するフィールド値が変更された場合は AcceptChanges 呼出の後 Original 値はデータソースの値と一致しなく成る 例 DataAdapter の UpdateCommand を明示的に設定して 変更済みの行に対して更新を実行する方法を次の例に示す UPDATE ステートメントの WHERE 句に指定したパラメータが SourceColumn の Original 値を使用する様に設定されて居る事に注意され度い Current 値が既に変更されて居る可能性 然して データソースの値と一致して居ない可能性が有る為 此の設定は重要で有る Original 値は データソースから DataTable にデータを取得する為に使用された値で有る ' Assumes connection is a valid SqlConnection. Dim adapter As SqlDataAdapter = New SqlDataAdapter( _ "SELECT CategoryID, CategoryName FROM Categories", connection) adapter.updatecommand = New SqlCommand( _ "UPDATE Categories SET CategoryName " & _ "WHERE CategoryID connection) adapter.updatecommand.parameters.add( _ "@CategoryName", SqlDbType.NVarChar, 15, "CategoryName") Dim parameter As SqlParameter = adapter.updatecommand.parameters.add( _ "@CategoryID", SqlDbType.Int) -17-

18 parameter.sourcecolumn = "CategoryID" parameter.sourceversion = DataRowVersion.Original Dim dataset As DataSet = New DataSet adapter.fill(dataset, "Categories") Dim row As DataRow = dataset.tables("categories").rows(0) row("categoryname") = "New Category" adapter.update(dataset, "Categories") // Assumes connection is a valid SqlConnection. SqlDataAdapter dataadpater = new SqlDataAdapter( "SELECT CategoryID, CategoryName FROM Categories", connection); dataadpater.updatecommand = new SqlCommand( "UPDATE Categories SET CategoryName " + "WHERE CategoryID connection); dataadpater.updatecommand.parameters.add( "@CategoryName", SqlDbType.NVarChar, 15, "CategoryName"); SqlParameter parameter = dataadpater.updatecommand.parameters.add( "@CategoryID", SqlDbType.Int); parameter.sourcecolumn = "CategoryID"; parameter.sourceversion = DataRowVersion.Original; DataSet dataset = new DataSet( ); dataadpater.fill(dataset, "Categories"); DataRow row = dataset.tables["categories"].rows[0]; row ["CategoryName"] = "New Category"; dataadpater.update(dataset, "Categories"); AutoIncrement 列 データソースからのテーブルに自動インクリメント列が有る場合 DataSet の列に値を格納するには 自動インクリメント値をストアドプロシージャの出力パラメータと仕て返して其れをテーブルの列に割り当てるか 又は DataAdapter の RowUpdated イベントを使用する 此の例に付いては ID 値及び Autonumber 値の取得 を参照され度い 但し DataSet 内の値はデータソースの値と同期しなく成る為 予期しない動作を発生する場合が有る 例えば CustomerID と謂う自動インクリメント主キー列を持つテーブルが有るとする DataSet 内に新しい 2 人の顧客を追加した場合 此等の顧客は自動インクリメント CustomerId 値 1 及び 2 を受け取る 2 行目の顧客行が DataAdapter の Update メソッドに渡されると 新しく追加された行は データソースで自動インクリメント CustomerID 値 1 を受け取る 此れは DataSet 内の値 2 とは一致しない DataAdapter が DataSet の行に戻り値を設定すると 1 行目の顧客行が既に CustomerID 値と仕て 1 を持つ為 制約違反が発生する 此の様な動作を防ぐには データソースの自動インクリメント列 及び DataSet の自動インクリメント値を使用する時に AutoIncrementStep を -1 AutoIncrementSeed を 0 に設定して DataSet に列を作成し 同時に 1 から始まり正のステップ値でインクリメントする自動インクリメント ID 値がデータソースで生成される様にする 其の結果 DataSet では自動インクリメント値と仕て負の数値が生成される為 データソースで生成される正の自動インクリメント値と矛盾しなく成る 今 1 つの方法は 自 -18-

19 動インクリメント列の代わりに Guid 型の列を使用する事で有る Guid 値生成のアルゴリズムでは データソースで生成される Guid と同じ Guid が DataSet で生成される事は無い DataTable の列を定義する方法の詳細に付いては DataTable のスキーマの定義 を参照され度い 挿入 更新 削除の順序 通常の条件下では DataSet を使用して行う変更の順序をデータソースに送信する事が重要で有る 例えば 既存の行の主キーの値を更新し 其の新しい主キーの値で新しい行を追加する場合 更新は挿入の前に処理する必要が有る DataTable の Select メソッドを使用すると 特定の RowState を持つ行丈を参照する DataRow 配列を返す事が出来る 其の後で 返された DataRow 配列を DataAdapter の Update メソッドに渡して変更行を処理出来る 更新する行のサブセットを指定する事で 挿入 更新 及び 削除の処理順序を制御出来る 例 例えば次のコードでは テーブルの削除行を最初に処理し 次に更新行 最後に挿入行を処理する Dim table As DataTable = dataset.tables("customers") ' First process deletes. dataset.update(table.select(nothing, Nothing, DataViewRowState.Deleted)) ' Next process updates. adapter.update(table.select(nothing, Nothing, DataViewRowState.ModifiedCurrent)) ' Finally, process inserts. dataadpater.update(table.select(nothing, Nothing, DataViewRowState.Added)) DataTable table = dataset.tables["customers"]; // First process deletes. adapter.update(table.select(null, null, DataViewRowState.Deleted)); // Next process updates. adapter.update(table.select(null, null, DataViewRowState.ModifiedCurrent)); // Finally, process inserts. adapter.update(table.select(null, null, DataViewRowState.Added)); DataSet への既存の制約の追加 DataAdapter の Fill メソッドは DataSet にデータソースからのテーブルの列と行丈を格納する 制約は一般にデータソースで設定されるが 既定では Fill メソッドは DataSet にスキーマ情報を追加しない データソースからの既存の主キー制約情報を DataSet に設定するには DataAdapter の FillSchema メソッドを呼び出すか 又は Fill を呼び出す前に DataAdapter の MissingSchemaAction プロパティを AddWithKey に設定する 此れに依り データソースの主キー制約が DataSet の主キー制約に反映される 外部キー制約情報はインクルードされない為 テーブルへの制約の追加 で示す様に明示的に作成する必要が有る DataSet 内にデータを格納する前にスキーマ情報を追加すると 主キー制約が DataSet 内の DataTable -19-

20 オブジェクトにインクルードされる 其の結果 DataSet に対して格納を行う追加の呼出を行った時 其の主キー列情報を使用してデータソースから得られた新しい行と各 DataTable の現在の行を一致させ 各テーブルの現在のデータをデータソースのデータで上書きする スキーマ情報が無いと DataSet にデータソースからの新しい行が付け加えられ 重複行が発生する メモ : データソースの列を自動インクリメント列と仕て指定した場合は FillSchema メソッド (MissingSchemaAction を AddWithKey に設定した Fill メソッド ) が AutoIncrement プロパティを true に設定した DataColumn を作成する 但し AutoIncrementStep 値と AutoIncrementSeed 値は明示的に設定する必要が有る 自動インクリメント列の詳細に付いては AutoIncrement 列の作成 を参照され度い FillSchema の使用や MissingSchemaAction の設定を AddWithKey にする場合 データソースで主キー列情報を確認する為の追加の処理が必要に成る 此の追加の処理に依りパフォーマンスが低下する場合が有る デザイン時に主キー情報が解って居る場合は 最適のパフォーマンスを得る為に主キー列 ( 複数の場合も有る ) を明示的に指定する事を推奨する テーブルに関する主キー情報を明示的に設定する方法に付いては テーブルの主キーの定義 を参照され度い FillSchema を使用して DataSet にスキーマ情報を追加する方法を次のコード例に示す Dim custdataset As DataSet = New DataSet( ) custadapter.fillschema(custdataset, SchemaType.Source, "Customers") custadapter.fill(custdataset, "Customers") DataSet custdataset = new DataSet( ); custadapter.fillschema(custdataset, SchemaType.Source, "Customers"); custadapter.fill(custdataset, "Customers"); Fill メソッドの MissingSchemaAction.AddWithKey プロパティを使用してスキーマ情報を DataSet に追加する方法を次のコード例に示す Dim custdataset As DataSet = New DataSet( ) custadapter.missingschemaaction = MissingSchemaAction.AddWithKey custadapter.fill(custdataset, "Customers") DataSet custdataset = new DataSet( ); custadapter.missingschemaaction = MissingSchemaAction.AddWithKey; custadapter.fill(custdataset, "Customers"); 複数結果セット DataAdapter は SelectCommand から返された複数の結果セットを検出すると DataSet に複数のテーブルを作成する 此等のテーブルには 0 から始まるインクリメンタル既定名 TableN が割り当てられる 従って Table0 ではなく Table から始まる テーブル名が FillSchema メソッドに引数と仕て渡されると 0 からから始まるインクリメンタル名 TableNameN が割り当てられる 此処では TableName0 ではなく TableName から始まる メモ :OleDbDataAdapter オブジェクトの FillSchema メソッドが複数の結果セットを返すコマンドと -20-

21 仕て呼び出された場合は 最初の結果セットのスキーマ情報が返される OleDbDataAdapter を使用して複数の結果セットのスキーマ情報を返す時は Fill メソッドを呼び出す時に AddWithKey に設定した MissingSchemaAction を指定してスキーマ情報を取得する事を推奨する DataAdapter に依るパラメータの使用 DataAdapter は データソースからデータを取得したりデータソースのデータを更新したりする為に使用される 次の 4 つのプロパティを持って居る SelectCommand プロパティは データソースからデータを返す InsertCommand UpdateCommand 及び DeleteCommand の各プロパティは データソースの変更を管理する為に使用する SelectCommand プロパティは DataAdapter の Fill メソッドを呼び出す前に設定する必要が有る InsertCommand UpdateCommand DeleteCommand の各プロパティは DataAdapter の Update メソッドを呼び出す前に DataSet 内のデータに対して行われた変更に基づいて設定する必要が有る 例えば 行が追加された場合 InsertCommand は Update 呼出の前に設定されて居る必要が有る Update が挿入行 更新行 又は 削除行を処理して居る時 DataAdapter が夫々れの Command プロパティを使用して其のアクションを処理する 変更された行に付いての現在の情報が Parameters コレクションを通じて Command オブジェクトに渡される データソースの行を更新する時は 一意識別子を使用してテーブル内の更新する列を識別する UPDATE ステートメントを呼び出す 一意識別子は 一般には主キーフィールドの値で有る UPDATE ステートメントは 次の Transact-SQL ステートメントで示す様に 一意識別子 及び 更新する列と値の両方を含むパラメータを使用する UPDATE Customers SET CompanyName WHERE CustomerID 更新する列 値 一意識別子 メモ : パラメータのプレースホルダの構文は データソースに依って異なる 次に SQL Server のデータソースのプレースホルダの例を示す 猶 System.Data.OleDb パラメータや System.Data.Odbc パラメータでは プレースホルダと仕て 疑問符 (? ) を使用する 此の の例では CompanyName フィールドは CustomerID パラメータの値で更新される 此等のパラメータは SqlParameter オブジェクトの SourceColumn プロパティを使用して 変更された行から情報を取得する 前のサンプル UPDATE ステートメントのパラメータを次に示す 此のコードは 変数 adapter が有効な SqlDataAdapter オブジェクトを表す事を前提と仕て居る adapter.parameters.add("@companyname", SqlDbType.NChar, 15, "CompanyName") Dim parameter As SqlParameter = _ adapter.updatecommand.parameters.add("@customerid", _ SqlDbType.NChar, 5, "CustomerID") parameter.sourceversion = DataRowVersion.Original Parameters コレクションの Add メソッドは パラメータ名 DataAdapter 固有の型 サイズ ( 其の型に適用可能な場合 ) 及び DataTable の SourceColumn パラメータの SourceVersion が Original に設定されて居る事に注意され度い 此の設定に依り 変更済みの DataRow の中で 識別を行う 1 つ 又は 複数の列の値が既に変更されて居る場合に データソース内の既存の行を更新する事を保証出来る 識別列の値が既に変更されて居る場合は Original 行の値はデータソースの現在の値と一致し Current パラメータの SourceVersion は設定されて居ない為 既定の Current の行の値が使用される -21-

22 SqlClient の例 SQL ステートメントを SqlDataAdapter の SelectCommand InsertCommand UpdateCommand DeleteCommand の各プロパティの CommandText と仕て使用する例を次に示す SqlDataAdapter オブジェクトの場合は 名前付きのパラメータを使用する必要が有る Dim selectsql As String = _ "SELECT CustomerID, CompanyName FROM Customers " & _ "WHERE CountryRegion AND City Dim insertsql As String = _ "INSERT INTO Customers (CustomerID, CompanyName) " & _ "VALUES Dim updatesql As String = _ "UPDATE Customers SET CustomerID & _ "CompanyName " & _ "WHERE CustomerID Dim deletesql As String = _ "DELETE FROM Customers WHERE CustomerID string selectsql = "SELECT CustomerID, CompanyName FROM Customers WHERE CountryRegion = " + "@CountryRegion AND City string insertsql = "INSERT INTO Customers (CustomerID, CompanyName) " + "VALUES string updatesql = "UPDATE Customers SET CustomerID " + "CompanyName WHERE CustomerID string deletesql = "DELETE FROM Customers WHERE CustomerID OleDb 又は Odbc の例 OleDbDataAdapter オブジェクトと OdbcDataAdapter オブジェクトの場合は 疑問符 (? ) のプレースホルダを使用してパラメータを識別する必要が有る Dim selectsql As String = _ "SELECT CustomerID, CompanyName FROM Customers " & _ "WHERE CountryRegion =? AND City =?" Dim insertsql AS String = _ "INSERT INTO Customers (CustomerID, CompanyName) VALUES (?,?)" Dim updatesql AS String = _ "UPDATE Customers SET CustomerID =?, CompanyName =? WHERE CustomerID =?" Dim deletesql As String = "DELETE FROM Customers WHERE CustomerID =?" string selectsql = "SELECT CustomerID, CompanyName FROM Customers " + "WHERE CountryRegion =? AND City =?"; string insertsql = "INSERT INTO Customers (CustomerID, CompanyName) VALUES (?,?)"; string updatesql = "UPDATE Customers SET CustomerID =?, CompanyName =? WHERE CustomerID =? "; string deletesql = "DELETE FROM Customers WHERE CustomerID =?"; -22-

23 パラメータと仕て使用されるクエリステートメントは 作成する必要の有る入力パラメータと出力パラメータを定義する パラメータを作成するには Parameters.Add メソッドか Parameter コンストラクタを使用して列名 データ型 及び サイズを指定する Integer 等組み込みのデータ型の場合は サイズを含める必要は無いし 其の場合は自動的に既定のサイズを指定する事に成る 前の例の SQL ステートメントのパラメータを作成し DataSet にデータを格納するコード例を次に示す SqlClient ' Assumes that connection is a valid SqlConnection object. Dim adapter As SqlDataAdapter = New SqlDataAdapter Dim selectcmd AS SqlCommand = New SqlCommand(selectSQL, connection) adapter.selectcommand = selectcmd ' Add parameters and set values. selectcmd.parameters.add("@countryregion", SqlDbType.NVarChar, 15).Value = "UK" selectcmd.parameters.add("@city", SqlDbType.NVarChar, 15).Value = "London" Dim customers As DataSet = New DataSet adapter.fill(customers, "Customers") // Assumes that connection is a valid SqlConnection object. SqlDataAdapter adapter = new SqlDataAdapter( ); SqlCommand selectcmd = new SqlCommand(selectSQL, connection); adapter.selectcommand = selectcmd; // Add parameters and set values. selectcmd.parameters.add("@countryregion", SqlDbType.NVarChar, 15).Value = "UK"; selectcmd.parameters.add("@city", SqlDbType.NVarChar, 15).Value = "London"; DataSet customers = new DataSet( ); adapter.fill(customers, "Customers"); OleDb ' Assumes that connection is a valid OleDbConnection object. Dim adapter As OleDbDataAdapter = New OleDbDataAdapter Dim selectcmd AS OleDbCommand = New OleDbCommand(selectSQL, connection) adapter.selectcommand = selectcmd ' Add parameters and set values. selectcmd.parameters.add("@countryregion", OleDbType.VarChar, 15).Value = "UK" selectcmd.parameters.add("@city", OleDbType.VarChar, 15).Value = "London" Dim customers As DataSet = New DataSet adapter.fill(customers, "Customers") // Assumes that connection is a valid OleDbConnection object. -23-

24 OleDbDataAdapter adapter = new OleDbDataAdapter( ); OleDbCommand selectcmd = new OleDbCommand(selectSQL, connection); adapter.selectcommand = selectcmd; // Add parameters and set values. selectcmd.parameters.add("@countryregion", OleDbType.VarChar, 15).Value = "UK"; selectcmd.parameters.add("@city", OleDbType.VarChar, 15).Value = "London"; DataSet customers = new DataSet( ); adapter.fill(customers, "Customers"); Odbc ' Assumes that connection is a valid OdbcConnection object. Dim adapter As OdbcDataAdapter = New OdbcDataAdapter Dim selectcmd AS OdbcCommand = New OdbcCommand(selectSQL, connection) adapter.selectcommand = selectcmd ' Add Parameters and set values. selectcmd.parameters.add("@countryregion", OdbcType.VarChar, 15).Value = "UK" selectcmd.parameters.add("@city", OdbcType.VarChar, 15).Value = "London" Dim customers As DataSet = New DataSet adapter.fill(customers, "Customers") // Assumes that connection is a valid OdbcConnection object. OdbcDataAdapter adapter = new OdbcDataAdapter( ); OdbcCommand selectcmd = new OdbcCommand(selectSQL, connection); adapter.selectcommand = selectcmd; //Add Parameters and set values. selectcmd.parameters.add("@countryregion", OdbcType.VarChar, 15).Value = "UK"; selectcmd.parameters.add("@city", OdbcType.VarChar, 15).Value = "London"; DataSet customers = new DataSet( ); adapter.fill(customers, "Customers"); メモ : 或るパラメータに対してパラメータ名がサポートされて居ない場合は Parameter1 から増分して行く既定名 ParameterN が割り当てられる パラメータ名を指定する時には ParameterN の名前付けルールを使用しない事を推奨する 此れは 指定した名前が ParameterCollection 内の既存のパラメータ名と競合しない様にする為で有る 指定した名前が既に存在する場合は 例外がスローされる Parameter.DbType パラメータの型は.NET Framework データプロバイダに固有の属性で有る型が指定されて居る場合は 其の値がデータソースに渡される前に Parameter の値.NET Framework データプロバイダ型に変換される Parameter オブジェクトの DbType プロパティを特定の DbType に設定する一般的な方法で Parameter の型を指定する事も出来る Parameter オブジェクトの.NET Framework データプロバイダ型は Parameter オブジェクトの Value -24-

25 の.NET Framework 型か 又は Parameter オブジェクトの DbType から推論される Parameter 値と仕て渡されるオブジェクト 又は 指定された DbType に基づいて推論される Parameter 型を 次の表に示す Framework System.Data.DbType SqlDbType OleDbType OdbcType OracleType bool Boolean Bit Boolean Bit Byte byte Byte TinyInt UnsignedTinyInt TinyInt Byte byte[] Binary VarBinary 1 VarBinary Binary Raw char 2 Char Char Byte DateTime DateTime DateTime DBTimeStamp DateTime DateTime Decimal Decimal Decimal Decimal Numeric Number double Double Float Double Double Double float Single Real Single Real Float Guid Guid UniqueIdentifier Guid UniqueIdentifier Raw Int16 Int16 SmallInt SmallInt SmallInt Int16 Int32 Int32 Int Int Int Int32 Int64 Int64 BitInt BigInt BigInt Number object Object Variant Variant 3 Blob string String NVarChar 4 VarWChar NVarChar NVarChar TimeSpan Time 5 DBTime Time DateTime UInt16 UInt16 6 UnsignedSmallInt Int UInt16 UInt32 UInt32 7 UnsignedInt BigInt UInt32 UInt64 UInt64 8 UnsignedBigInt Numeric Number AnsiString VarChar VarChar VarChar VarChar AnsiStringFixedLength Char Char Char Char Currency Money Currency 9 Number Date A DBDate Date DateTime SByte B TinyInt C SByte StringFixedLength NChar WChar NChar NChar Time D DBTime Time DateTime VarNumeric E VarNumeric F Number 1 バイト配列が VarBinary の最大サイズ (8000 バイト ) より大きい場合は 此の暗黙の変換はエラーに成る 8000 バイトを超えるバイト配列の場合は 明示的に SqlDbType を設定する 2 char からの SqlDbType の推論はサポートされて居ない 3 Object からの OdbcType の推論はサポートされて居ない 4 文字列が NVarChar の最大サイズ (4000 文字 ) より大きい場合 此の暗黙の変換はエラーに成る 4000 文字を超える文字列の場合は 明示的に SqlDbType を設定する 5 TimeSpan からの SqlDbType の推論はサポートされて居ない 6 UInt16 からの SqlDbType の推論はサポートされて居ない 7 UInt32 からの SqlDbType の推論はサポートされて居ない 8 UInt64 からの SqlDbType の推論はサポートされて居ない 9 Currency からの OdbcType の推論はサポートされて居ない A Date からの SqlType の推論はサポートされて居ない B SByte からの SqlType の推論はサポートされて居ない C SByte からの OdbcType の推論はサポートされて居ない D Time からの SqlType の推論はサポートされて居ない E VarNumeric からの SqlDbType の推論はサポートされて居ない F VarNumeric からの OdbcType の推論はサポートされて居ない メモ :.NET Framework Version 1.0 に同梱されて居る.NET Framework データプロバイダは Decimal パラメータ値の Precision と Scale を確認しない為 切り捨てられたデータがデータソースに挿入される事が有る.NET Framework Version 1.0 を使用して居る場合は Decimal 値の Precision と Scale を検証してからパラメータ値を設定する.NET Framework Version 1.1 以降では Decimal パラメータ値で無効な Precision が設定されて居る場合 例外がスローされる Decimal パラメータスケールを超える Scale 値は 切り捨てられる -25-

26 メモ :.NET Framework Version 1.0 以降では System.Data.SqlTypes を System.Data.SqlClient と共に使用する事が出来る 詳細に付いては SqlTypes の使用 を参照され度い Parameter.Direction Parameter の Direction を設定する為に ParameterDirection 列挙型で使用出来る値を次の表に示す メンバ名 説明 Input 此のパラメータは入力パラメータで有る ( 此れは 既定の設定で有る ) InputOutput 此のパラメータは入力と出力の両方の機能を持って居る Output 此のパラメータは出力パラメータで有る ReturnValue 此のパラメータは戻り値を表す Parameter の Direction を設定する方法を次のコード例に示す parameter.direction = ParameterDirection.Output Parameter.SourceColumn Parameter.SourceVersion SourceColumn 及び SourceVersion は Parameter コンストラクタに記述子と仕て渡したり 既存の Parameter のプロパティと仕て設定する事も出来る SourceColumn は Parameter の値の取得元で有る DataRow の DataColumn の名前で有る SourceVersion は DataAdapter が値を取得する為に使用する DataRow バージョンを指定する SourceVersion で使用出来る DataRowVersion 列挙型の値を次の表に示す メンバ名 説明 Current 此のパラメータは列の現在の値を使用する ( 此れは 既定の設定で有る ) Default 此のパラメータは列の DefaultValue を使用する Original 此のパラメータは列の元の値を使用する Proposed 此のパラメータは提示された値を使用する CustomerID 列を 2 CustomerID ) CustomerID の SourceColumn と仕て使用する UPDATE パラメータは CustomerID 列を DataRow の現在の値に更新する為に使用されて居る 其の為 SourceVersion を Current に設定した CustomerID SourceColumn パラメータは データソースの現在の行を識別する為に使用されて居る 其の行の Original バージョンで一致する列の値が見付かった為 SourceVersion を Original に設定した同じ SourceColumn(CustomerID) が使用されて居る SqlClient adapter.updatecommand.parameters.add( _ "@CustomerID", SqlDbType.NChar, 5, "CustomerID") adapter.updatecommand.parameters.add( _ "@CompanyName", SqlDbType.NVarChar, 40, "CompanyName") Dim parameter As SqlParameter = _ adapter.updatecommand.parameters.add("@oldcustomerid", _ SqlDbType.NChar, 5, "CustomerID") parameter.sourceversion = DataRowVersion.Original -26-

27 adapter.updatecommand.parameters.add( SqlDbType.NChar, 5, "CustomerID"); adapter.updatecommand.parameters.add( SqlDbType.NVarChar, 40, "CompanyName"); SqlParameter parameter = adapter.updatecommand.parameters.add( "@OldCustomerID", SqlDbType.NChar, 5, "CustomerID"); parameter.sourceversion = DataRowVersion.Original; UpdatedRowSource Command オブジェクトの UpdatedRowSource プロパティを使用すると データソースから返された値を DataSet に割り当てる方法を制御出来る UpdatedRowSource プロパティを UpdateRowSource 列挙型の値の 1 つに設定する事で DataAdapter コマンドが返したパラメータを無視するか DataSet 内の変更行に適用するかを制御出来る 最初に返された行 ( 存在する場合 ) を DataSet 内の変更行に適用するか何うかを指定する事も出来る UpdateRowSource 列挙型の様々の値と 其等の値が DataAdapter で使用されるコマンドの動作に何の様に影響するかを次の表で説明する UpdateRowSource 説明 Both 出力パラメータと返された結果セットの最初の行を DataSet 内の変更行に割り当てる FirstReturnedRecord 返された結果セットの最初の行のデータ丈を DataSet 内の変更行に割り当てる None 出力パラメータ又は返された結果セットの行が無視される OutputParameters 出力パラメータ丈を DataSet 内の変更行に割り当てる パラメータと戻り値の指定 ストアドプロシージャには 入力パラメータと出力パラメータの他に戻り値を含める事が出来る 次の例は ADO.NET が新しいレコードを 主キー列が SQL Server データベースの ID 列と成って居るテーブルに挿入して 入力パラメータ 出力パラメータ 及び 戻り値を受け渡す例を説明して居る 例 此の例では 次のストアドプロシージャを使用して Northwind Categories テーブルに新しいカテゴリを挿入する 此のストアドプロシージャは CategoryName 列の値を入力パラメータと仕て受け取り SCOPE_IDENTITY( ) 関数を使用して ID フィールド CategoryID の新しい値を取得し 其の値を出力パラメータ内に返す RETURN 関数を使用して 挿入された行の数を返す CREATE PROCEDURE int OUTPUT AS SET NOCOUNT ON INSERT INTO Categories (CategoryName) VALUES(@CategoryName) = SCOPE_IDENTITY( ) -27-

28 上述の InsertCategory ストアドプロシージャを SqlDataAdapter の InsertCommand 出力パラメータと戻り値は SqlDataAdapter の Update メソッドが呼び出され データベースにレコードが挿入された後で DataSet に反映される メモ : OleDbDataAdapter を使用する場合 ReturnValue の ParameterDirection を含むパラメータを他のパラメータより先に指定する必要が有る ' Assumes that connection represents a SqlConnection object. Dim adapter As SqlDataAdapter = New SqlDataAdapter( _ "SELECT CategoryID, CategoryName FROM dbo.categories", connection) adapter.insertcommand = New SqlCommand("InsertCategory", connection) adapter.insertcommand.commandtype = CommandType.StoredProcedure Dim parameter As SqlParameter = adapter.insertcommand.parameters.add( _ "@RowCount", SqlDbType.Int) parameter.direction = ParameterDirection.ReturnValue adapter.insertcommand.parameters.add( _ "@CategoryName", SqlDbType.NChar, 15, "CategoryName") parameter = adapter.insertcommand.parameters.add( _ "@Identity", SqlDbType.Int, 0, "CategoryID") parameter.direction = ParameterDirection.Output Dim categoriesds As DataSet = New DataSet( ) adapter.fill(categoriesds, "Categories") Dim newrow As DataRow = categoriesds.tables("categories").newrow( ) newrow("categoryname") = "New Category" categoriesds.tables("categories").rows.add(newrow) adapter.update(categoriesds, "Categories") Dim rowcount As Int32 = CInt(adapter.InsertCommand.Parameters("@RowCount").Value) // Assumes that connection represents a SqlConnection object. SqlDataAdapter adapter = new SqlDataAdapter( "SELECT CategoryID, CategoryName FROM dbo.categories", connection); adapter.insertcommand = new SqlCommand("InsertCategory", connection); adapter.insertcommand.commandtype = CommandType.StoredProcedure; SqlParameter parameter = adapter.insertcommand.parameters.add( "@RowCount", SqlDbType.Int); parameter.direction = ParameterDirection.ReturnValue; adapter.insertcommand.parameters.add( "@CategoryName", SqlDbType.NChar, 15, "CategoryName"); parameter = adapter.insertcommand.parameters.add( -28-