チュートリアル: 複合データ バインディングをサポートする Windows フォーム ユーザー コントロールの作成
Windows アプリケーションのフォームにデータを表示する場合は、ツールボックスから既存のコントロールを選択するか、またはアプリケーションが標準コントロールでは提供できない機能を必要とする場合は、カスタム コントロールを記述できます。このチュートリアルでは、ComplexBindingPropertiesAttribute を実装するコントロールを作成する方法を示します。ComplexBindingPropertiesAttribute を実装するコントロールには、データにバインドできる DataSource プロパティと DataMember プロパティが含まれます。このようなコントロールは、DataGridView または ListBox に似ています。
コントロールの作成の詳細については、「デザイン時の Windows フォーム コントロールの開発」を参照してください。
データ バインディングのシナリオで使用するコントロールを作成するときは、次のいずれかのデータ バインディング属性を実装する必要があります。
データ バインド属性の使用 |
---|
単一のデータ列またはプロパティを表示する TextBox のような DefaultBindingPropertyAttribute を簡単なコントロールに実装します。詳細については、「チュートリアル: 単純データ バインディングをサポートする Windows フォーム ユーザー コントロールの作成」を参照してください。 |
データの一覧またはテーブルを表示する DataGridView のような ComplexBindingPropertiesAttribute をコントロールに実装します。このチュートリアルでは、このプロセスについて説明します。 |
データの一覧またはテーブルを表示しますが、単一の列またはプロパティを表示する必要もある ComboBox のような LookupBindingPropertiesAttribute をコントロールに実装します。詳細については、「チュートリアル: 検索データ バインディングをサポートする Windows フォーム ユーザー コントロールの作成」を参照してください。 |
このチュートリアルでは、テーブルからデータの行を表示する複合コントロールを作成します。この例では、Northwind サンプル データベースの Customers テーブルを使用します。複合ユーザー コントロールは、カスタム コントロールの DataGridView に顧客テーブルを表示します。
このチュートリアルでは、次の作業を行う方法について説明します。
新しい Windows アプリケーションを作成します。
新しいユーザー コントロールをプロジェクトに追加します。
ユーザー コントロールをビジュアルに設計します。
ComplexBindingProperty 属性を実装します。
データ ソース構成ウィザードを使用して、データセットを作成します。
[データ ソース] ウィンドウ の Customers テーブルが新しい複合コントロールを使用するように設定します。
[データ ソース] ウィンドウから Form1 に新しいコントロールをドラッグして追加します。
必須コンポーネント
このチュートリアルを完了するための要件は次のとおりです。
- Northwind サンプル データベースにアクセスします。詳細については、「方法 : サンプル データベースをインストールする」を参照してください。
Windows アプリケーションの作成
最初に Windows アプリケーションを作成します。
新しい Windows プロジェクトを作成するには
Visual Studio の [ファイル] メニューの [新しいプロジェクト] をクリックします。
プロジェクトに ComplexControlWalkthrough という名前を付けます。
[Windows アプリケーション] をクリックし、[OK] をクリックします。詳細については、「クライアント アプリケーションの開発」を参照してください。
ComplexControlWalkthrough プロジェクトが作成されてソリューション エクスプローラーに追加されます。
プロジェクトへのユーザー コントロールの追加
このチュートリアルではユーザー コントロールからデータ バインディング可能な複合コントロールを作成するので、ユーザー コントロールの項目をプロジェクトに追加する必要があります。
プロジェクトにユーザー コントロールを追加するには
[プロジェクト] メニューの [ユーザー コントロールの追加] をクリックします。
[ファイル名] 領域に「ComplexDataGridView」と入力し、[追加] をクリックします。
ComplexDataGridView コントロールが ソリューション エクスプローラーに追加され、デザイナーが開きます。
ComplexDataGridView コントロールの設計
この手順では、DataGridView をユーザー コントロールに追加します。
ComplexDataGridView コントロールを設計するには
- ツールボックスからユーザー コントロールのデザイン サーフェイスに DataGridView をドラッグします。
必要なデータ バインディング属性の追加
データ バインディングをサポートする複合コントロールには、ComplexBindingPropertiesAttribute を実装できます。
ComplexBindingProperties 属性を実装するには
ComplexDataGridView コントロールをコード ビューに切り替えます。[表示] メニューの [コード] をクリックします。
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(); } } }
[ビルド] メニューの [ソリューションのビルド] をクリックします。
データベースからのデータ ソースの作成
この手順では、データ ソース構成ウィザードを使用して、Northwind サンプル データベースの Customers テーブルに基づいてデータ ソースを作成します。接続を作成するには、Northwind サンプル データベースにアクセスできる必要があります。Northwind サンプル データベースのセットアップの詳細については、「方法 : サンプル データベースをインストールする」を参照してください。
データ ソースを作成するには
[データ] メニューの [データ ソースの表示] をクリックします。
[データ ソース] ウィンドウで、[新しいデータ ソースの追加] をクリックしてデータ ソース構成ウィザードを起動します。
[データソースの種類を選択] ページで、[データベース] をクリックし、[次へ] をクリックします。
[データ接続の選択] ページで、次のいずれかの操作を行います。
Northwind サンプル データベースへのデータ接続がドロップダウン リストに表示されている場合は選択します。
または
[新しい接続] を選択して [接続の追加] または [接続の変更] ダイアログ ボックスを表示します。詳細については、「[接続の追加] ダイアログ ボックスと [接続の変更] ダイアログ ボックス (一般)」を参照してください。
データベースにパスワードが必要な場合は、該当するオプションを選択して重要情報を含め、[次へ] をクリックします。
[アプリケーション構成ファイルに接続文字列を保存] ページで、[次へ] をクリックします。
[データベース オブジェクトの選択] ページの [テーブル] ノードを展開します。
Customers テーブルを選択し、[完了] をクリックします。
プロジェクトに NorthwindDataSet が追加され、[データ ソース] ウィンドウに Customers テーブルが表示されます。
ComplexDataGridView コントロールを使用するように Customers テーブルを設定する
[データ ソース] ウィンドウでは、フォームにコントロールをドラッグする前に作成するコントロールを設定できます。
Customers テーブルを ComplexDataGridView コントロールにバインドするように設定するには
デザイナーで Form1 を開きます。
[データ ソース] ウィンドウの [Customers] ノードを展開します。
[Customers] ノードのドロップダウン矢印をクリックし、[カスタマイズ] を選択します。
[データ UI カスタマイズ オプション] ダイアログ ボックスの [関連付けられたコントロール] の一覧の [ComplexDataGridView] を選択します。
Customers テーブルのドロップダウン矢印をクリックし、コントロール一覧から ComplexDataGridView を選択します。
フォームへのコントロールの追加
[データ ソース] ウィンドウからフォームに項目をドラッグして、データ バインディング コントロールを作成します。
フォームにデータ バインディング コントロールを作成するには
- [データ ソース] ウィンドウからフォームにメインの [Customers] ノードをドラッグし、ComplexDataGridView コントロールを使用してテーブルのデータが表示されていることを確認します。
アプリケーションの実行
アプリケーションを実行するには
- F5 キーを押してアプリケーションを実行します。
次の手順
アプリケーションの要件に応じて、データ バインディングをサポートするコントロールの作成後に、追加の操作を実行できます。この後に実行できる一般的な手順を次に示します。
他のアプリケーションで再利用するために、カスタム コントロールをコントロール ライブラリに格納します。
検索のシナリオをサポートするコントロールを作成します。詳細については、「チュートリアル: 検索データ バインディングをサポートする Windows フォーム ユーザー コントロールの作成」を参照してください。
参照
処理手順
方法 : [データ ソース] ウィンドウからドラッグしたときに作成されるコントロールを設定する
概念
Visual Studio でのデータへの Windows フォーム コントロールのバインド
Visual Studio でのデータへのコントロールのバインド