バージョン

WinGrid を階層データ ソースにバインドする

このトピックではユーザーができるだけ早く操作に慣れることができるよう、WinGrid を Visual Studio .NET のフォームに追加するために最低限必要な基本手順について説明します。この手順では WinGrid コントロールを Visual Studio .NET プロジェクトに追加し、それを階層的なデータ ソースにバインドする方法について説明します。

WinGrid コントロールを階層データ ソースにバインドする

  1. 新しい Windows アプリケーションを作成します。

  2. ツールボックスで UltraGrid コントロールを選択し、フォームにコントロールを描画します。UltraGrid デザイナが表示されます。[完了] をクリックしてダイアログ ボックスを閉じます。

  3. [プロパティ] ウィンドウで、WinGrid の DataSource プロパティを選択してドロップダウン リストを表示します。ドロップダウン リストで、[プロジェクト データ ソースの追加…​] リンクをクリックします。

WinGrid Bind WinGrid to a Flat Data Source CLR2 01.png

  1. [データ ソース構成] ウィザードが表示します。このウィザードは、Database、Web Service、または Object に接続するときに役立ちます。Database を選択して [次へ] をクリックします。

  2. [データ接続を選択] ダイアログで、[新しい接続] ボタンを選択します。これによって [接続を追加] ダイアログが表示します。これによってデータベースの位置にナビゲートできます。この例では、Northwind データベース（NWind.mdb）を使用します。これは Infragistics SDK インストールの一部として使用できます。デフォルトで、NWind.mdb ファイルは以下のインストール フォルダに配置されています。 C:\Users\Public\Documents\Infragistics\2021.2\Windows Forms\Samples\Legacy\Data

    [参照…​] をクリックしてインストール パスを指定し、NWind.mdb ファイルを選択します。[接続を追加] ダイアログ ボックスは以下のように表示されます。接続が構築されたら [OK] をクリックします。

    WinGrid Bind WinGrid to a Flat Data Source CLR2 02.png

  1. [データ接続を選択] ダイアログで、[次へ] をクリックします。選択したデータ ファイルが現在のプロジェクトにないことを説明するダイアログが表示して、データ ファイルをプロジェクトにコピーするオプションを提供します。[はい] を選択します。

  2. 次に表示するダイアログがアプリケーション構成ファイル内のデータ ファイルにアクセスするために使用される接続文字列を保存するかどうかを尋ねます。[はい] をクリックします。Northwind.mdb ファイルに接続しているだけなのでセキュリティはここでは問題ではありません。

  3. [データベース オブジェクトを選択] ダイアログで、Tables ノードを展開し Customers テーブルと Orders テーブルを選択します。この選択が終わったら、[完了] を選択します。

WinGrid Bind WinGrid to a Hierarchical Data Source CLR2 01.png

  1. これが完了したら、DataSource プロパティに戻り、再度ダイアログをドロップダウンして、表示した [その他のデータ ソース] セクションを展開します。展開して、NWindDataSet と関連付けられた Customers テーブルを選択します。

WinGrid Bind WinGrid to a Hierarchical Data Source CLR2 02.png

  1. データセット、BindingSource および TableAdapter が生成され、フォームのコンポーネントとして追加されます。WinGrid は WinGrid 描画される時に表示される列を表示します。

  2. ソリューション エクスプローラでダブルクリックして、データセットに関連付けられた XSD ファイルを開きます。XSD のデザイナで、Customers テーブルを右クリックして、[追加] を選択し、次にサブメニューから [リレーション] を選択します。[リレーション] ダイアログが表示します。親テーブルとして Customers テーブルを選択し、子テーブルとして Orders テーブルを選択します。[リレーション] ダイアログが以下のスクリーンショットにように表示されます。

WinGrid Bind WinGrid to a Hierarchical Data Source CLR2 03.png

  1. [リレーション] ダイアログで [OK] を選択します。2 つのテーブル間のリレーション ラインで XSD の更新を確認します。プロジェクトをビルドし、WinGrid でフォームに戻る場合には、WinGrid は 2 つのテーブル間のリレーションをすでにピックアップしていることがわかります。

  2. フォーム固有のコンポーネントの下のツールボックスで、ordersTableAdapter を見つけて、フォームにドラッグします。このアダプタは、データでデータセットを埋めるためにフォーム上にすでにある customersTableAdapter とともに必要です。

  3. コード ビハインド ファイルに移動すると、フォームの Load イベントが接続されており、データ セットの Customers テーブルを埋めるために customersTableAdapter がすでに設定されていることを確認します。コードの以下の行を追加して、データ セットの Orders テーブルを埋めます。

Visual Basic の場合：

Me.OrdersTableAdapter1.Fill(Me.NWindDataSet.Orders)

C# の場合：

this.ordersTableAdapter1.Fill(this.nWindDataSet.Orders);

  1. アプリケーションを実行します。Customers テーブルからのデータで埋められたフォーム上にある WinGrid コントロールを確認します。行を展開すると、Orders テーブルからの関連している顧客のデータが確認できます。