チュートリアル : 複合データ バインディングをサポートするユーザー コントロールの作成

更新 : 2007 年 11 月

Windows アプリケーションのフォームにデータを表示する場合は、ツールボックスから既存のコントロールを選択するか、またはアプリケーションが標準コントロールでは提供できない機能を必要とする場合は、カスタム コントロールを記述できます。このチュートリアルでは、ComplexBindingPropertiesAttribute を実装するコントロールを作成する方法を示します。ComplexBindingPropertiesAttribute を実装するコントロールには、データにバインドできる DataSource プロパティと DataMember プロパティが含まれます。このようなコントロールは、DataGridView または ListBox に似ています。

コントロールの作成の詳細については、「デザイン時の Windows フォーム コントロールの開発」を参照してください。

データ バインディングのシナリオで使用するコントロールを作成するときは、次のいずれかのデータ バインディング属性を実装する必要があります。

このチュートリアルでは、テーブルからデータの行を表示する複合コントロールを作成します。この例では、Northwind サンプル データベースの Customers テーブルを使用します。複合ユーザー コントロールは、カスタム コントロールの DataGridView に顧客テーブルを表示します。

このチュートリアルでは、次の作業を行う方法について説明します。

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

• 新しいユーザー コントロールをプロジェクトに追加します。

• ユーザー コントロールをビジュアルに設計します。

• ComplexBindingProperty 属性を実装します。

• データ ソース構成ウィザードを使用して、データセットを作成します。

• [データ ソース] ウィンドウ の Customers テーブルが新しい複合コントロールを使用するように設定します。

• [データ ソース] ウィンドウから Form1 に新しいコントロールをドラッグして追加します。

前提条件

このチュートリアルを実行するための要件は次のとおりです。

• Northwind サンプル データベースにアクセスします。詳細については、「方法 : サンプル データベースをインストールする」を参照してください。

Windows アプリケーションの作成

最初に Windows アプリケーションを作成します。

新しい Windows プロジェクトを作成するには

1. Visual Studio の [ファイル] メニューの [新しいプロジェクト] をクリックします。

2. プロジェクトに ComplexControlWalkthrough という名前を付けます。

3. [Windows アプリケーション] をクリックし、[OK] をクリックします。詳細については、「Windows ベースのアプリケーションの作成」を参照してください。

   ComplexControlWalkthrough プロジェクトが作成されてソリューション エクスプローラに追加されます。

プロジェクトへのユーザー コントロールの追加

このチュートリアルではユーザー コントロールからデータ バインディング可能な複合コントロールを作成するので、ユーザー コントロールの項目をプロジェクトに追加する必要があります。

プロジェクトにユーザー コントロールを追加するには

1. [プロジェクト] メニューの [ユーザー コントロールの追加] をクリックします。

2. [ファイル名] 領域に「ComplexDataGridView」と入力し、[追加] をクリックします。

   ComplexDataGridView コントロールが ソリューション エクスプローラに追加され、デザイナが開きます。

ComplexDataGridView コントロールの設計

この手順では、DataGridView をユーザー コントロールに追加します。

ComplexDataGridView コントロールを設計するには

• ツールボックスからユーザー コントロールのデザイン サーフェイスに DataGridView をドラッグします。

必要なデータ バインディング属性の追加

データ バインディングをサポートする複合コントロールには、ComplexBindingPropertiesAttribute を実装できます。

ComplexBindingProperties 属性を実装するには

1. ComplexDataGridView コントロールをコード ビューに切り替えます。[表示] メニューの [コード] をクリックします。

2. ComplexDataGridView のコードを次のコードに置き換えます。

   <System.ComponentModel.ComplexBindingProperties("DataSource", "DataMember")> _
   Public Class ComplexDataGridView
   
       Public Property DataSource() As Object
           Get
               Return DataGridView1.DataSource
           End Get
           Set(ByVal value As Object)
               DataGridView1.DataSource = value
           End Set
       End Property
   
       Public Property DataMember() As String
           Get
               Return DataGridView1.DataMember
           End Get
           Set(ByVal value As String)
               DataGridView1.DataMember = value
           End Set
       End Property
   End Class
   

   using System.Windows.Forms;
   
   namespace CS
   {
       [System.ComponentModel.ComplexBindingProperties("DataSource", "DataMember")]
       public partial class ComplexDataGridView : UserControl
       {
           public object DataSource
           {
               get{ return dataGridView1.DataSource; }
               set{ dataGridView1.DataSource = value; }
           }
   
           public string DataMember
           {
               get{ return dataGridView1.DataMember; }
               set{ dataGridView1.DataMember = value; }
           }
   
           public ComplexDataGridView()
           {
               InitializeComponent();
           }
       }
   }
   

3. [ビルド] メニューの [ソリューションのビルド] をクリックします。

データベースからデータ ソースを作成する

この手順では、データ ソース構成ウィザードを使用して、Northwind サンプル データベースの Customers テーブルに基づいてデータ ソースを作成します。接続を作成するには、Northwind サンプル データベースにアクセスできる必要があります。Northwind サンプル データベースのセットアップの詳細については、「方法 : サンプル データベースをインストールする」を参照してください。

データ ソースを作成するには

1. [データ] メニューの [データ ソースの表示] をクリックします。

2. [データ ソース] ウィンドウで、[新しいデータ ソースの追加] をクリックしてデータ ソース構成ウィザードを起動します。

3. [データソースの種類を選択] ページで、[データベース] をクリックし、[次へ] をクリックします。

4. [データ接続の選択] ページで、次のいずれかの操作を行います。

   • Northwind サンプル データベースへのデータ接続がドロップダウン リストに表示されている場合は選択します。

     または

   • [新しい接続] を選択して [接続の追加] または [接続の変更] ダイアログ ボックスを表示します。詳細については、「[接続の追加] ダイアログ ボックスと [接続の変更] ダイアログ ボックス (一般)」を参照してください。

5. データベースにパスワードが必要な場合は、該当するオプションを選択して重要情報を含め、[次へ] をクリックします。

6. [アプリケーション構成ファイルに接続文字列を保存] ページで、[次へ] をクリックします。

7. [データベース オブジェクトの選択] ページの [テーブル] ノードを展開します。

8. Customers テーブルを選択し、[完了] をクリックします。

   プロジェクトに NorthwindDataSet が追加され、[データ ソース] ウィンドウに Customers テーブルが表示されます。

ComplexDataGridView コントロールを使用するように Customers テーブルを設定する

[データ ソース] ウィンドウでは、フォームにコントロールをドラッグする前に作成するコントロールを設定できます。

Customers テーブルを ComplexDataGridView コントロールにバインドするように設定するには

1. デザイナで Form1 を開きます。

2. [データ ソース] ウィンドウの [Customers] ノードを展開します。

3. [Customers] ノードのドロップダウン矢印をクリックし、[カスタマイズ] を選択します。

4. [データ UI カスタマイズ オプション] ダイアログ ボックスの [関連付けられたコントロール] の一覧の [ComplexDataGridView] を選択します。

5. Customers テーブルのドロップダウン矢印をクリックし、コントロール一覧から ComplexDataGridView を選択します。

フォームへのコントロールの追加

[データ ソース] ウィンドウからフォームに項目をドラッグして、データ バインディング コントロールを作成します。

フォームにデータ バインディング コントロールを作成するには

• [データ ソース] ウィンドウからフォームにメインの [Customers] ノードをドラッグし、ComplexDataGridView コントロールを使用してテーブルのデータが表示されていることを確認します。

アプリケーションの実行

アプリケーションを実行するには

• F5 キーを押してアプリケーションを実行します。

次の手順

アプリケーションの要件に応じて、データ バインディングをサポートするコントロールの作成後に、追加の操作を実行できます。この後に実行できる一般的な手順を次に示します。

• 他のアプリケーションで再利用するために、カスタム コントロールをコントロール ライブラリに格納します。詳細については、「Windows コントロール ライブラリ テンプレート」を参照してください。

• 検索のシナリオをサポートするコントロールを作成します。詳細については、「チュートリアル : 検索データ バインドをサポートするユーザー コントロールの作成」を参照してください。

参照

処理手順

方法 : [データ ソース] ウィンドウからドラッグしたときに作成されるコントロールを設定する

概念

データの表示の概要

その他の技術情報

Windows フォーム コントロール

Visual Studio でのデータへの接続

アプリケーションでデータを受け取る準備

アプリケーションへのデータのフェッチ

Windows アプリケーションのフォームでのデータの表示

アプリケーションでのデータ編集

データの検証

データの保存