参照データバインディングをサポートする .NET Framework Windows フォームユーザーコントロールを作成する

注

DataSet クラスと関連クラスは、アプリケーションがデータベースから切断されている間にアプリケーションがメモリ内のデータを操作できるようにする、2000 年代初頭のレガシ .NET Framework テクノロジです。このテクノロジは、ユーザーがデータを変更し、変更をデータベースに保持できるアプリに特に役立ちます。データセットは実証済みの成功したテクノロジですが、新しい .NET アプリケーションには Entity Framework Core を使用することをお勧めします。 Entity Framework は、オブジェクトモデルとして表形式データを操作するより自然な方法を提供し、よりシンプルなプログラミングインターフェイスを備えています。

Windows フォームにデータを表示する場合は、[ ツールボックス] から既存のコントロールを選択するか、アプリケーションで標準コントロールで使用できない機能が必要な場合はカスタムコントロールを作成できます。このチュートリアルでは、 LookupBindingPropertiesAttributeを実装するコントロールを作成する方法について説明します。 LookupBindingPropertiesAttributeを実装するコントロールには、データにバインドできる 3 つのプロパティを含めることができます。このようなコントロールは、 ComboBoxに似ています。

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

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

データバインディング属性の使用方法
データの単一の列 (またはプロパティ) を表示するDefaultBindingPropertyAttributeなどの単純なコントロールにTextBoxを実装します。詳細については、「単純なデータバインディングをサポートする Windows フォームユーザーコントロールを作成する」を参照してください。
データのリスト (またはテーブル) を表示するComplexBindingPropertiesAttributeなどのコントロールにDataGridViewを実装します。詳細については、「複雑なデータバインディングをサポートする Windows フォームユーザーコントロールを作成する」を参照してください。
データのリスト (またはテーブル) を表示するコントロール (LookupBindingPropertiesAttribute など) にComboBoxを実装しますが、1 つの列またはプロパティも表示する必要があります。 (このプロセスについては、このチュートリアルページで説明します)。

このチュートリアルでは、2 つのテーブルのデータにバインドする参照コントロールを作成します。この例では、Northwind サンプルデータベースの Customers テーブルと Orders テーブルを使用します。ルックアップコントロールは、CustomerID テーブルのOrders フィールドにバインドされます。この値を使用して、CompanyName テーブルからCustomersを検索します。

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

新しい Windows フォームアプリ (.NET Framework) を作成します。
新しい ユーザーコントロール をプロジェクトに追加します。
ユーザーコントロールを視覚的に設計します。
LookupBindingProperty属性を実装します。
データソース構成ウィザードを使用してデータセットを作成します。
新しいコントロールを使用するには、[データソース] ウィンドウの Orders テーブルの CustomerID 列を設定します。
新しいコントロールにデータを表示するフォームを作成します。

[前提条件]

このチュートリアルを完了するには、Visual Studio にインストールされている .NET デスクトップ開発ワークロードとデータストレージワークロードと処理ワークロードが必要です。インストールするには、Visual Studio インストーラー を開き、変更したい Visual Studio のバージョンの横にある [変更] （または [その他の >変更]）を選択します。 Visual Studio の変更に関するページを参照してください。

このチュートリアルでは、SQL Server Express LocalDB と Northwind サンプルデータベースを使用します。

SQL Server Express LocalDB がない場合は、 SQL Server Express のダウンロードページまたは Visual Studio インストーラーからインストールします。 Visual Studio インストーラーでは、データストレージと処理ワークロードの一部として、または個々のコンポーネントとして SQL Server Express LocalDB をインストールできます。
次の手順に従って Northwind サンプルデータベースをインストールします。
1. Visual Studio で、 SQL Server オブジェクトエクスプローラー ウィンドウを開きます。 (SQL Server オブジェクトエクスプローラーは、Visual Studio インストーラーの データストレージと処理 ワークロードの一部としてインストールされます)。 SQL Server ノードを展開します。 LocalDB インスタンスを右クリックし、[ 新しいクエリ] を選択します。
  
  クエリエディターウィンドウが開きます。
2. Northwind Transact-SQL スクリプトをクリップボードにコピーします。この T-SQL スクリプトは、Northwind データベースを最初から作成し、データを設定します。
3. T-SQL スクリプトをクエリエディターに貼り付け、[ 実行] ボタンを選択します。
  
  しばらくすると、クエリの実行が完了し、Northwind データベースが作成されます。

Windows フォームアプリプロジェクトを作成する

最初の手順では、 Windows フォームアプリ (.NET Framework) プロジェクトを作成します。

Visual Studio の [ファイル] メニューで､ [新規作成]>[プロジェクト] を選択します。
左側のウィンドウで Visual C# または Visual Basic を展開し、 Windows デスクトップを選択します。
中央のウィンドウで、 Windows フォームアプリ プロジェクトの種類を選択します。
プロジェクトに LookupControlWalkthrough という名前を付け、[ OK] を選択します。

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

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

このチュートリアルでは、 ユーザー コントロールからルックアップコントロールを作成するため、 ユーザーコントロール 項目を LookupControlWalkthrough プロジェクトに追加します。

[プロジェクト] メニューの [ユーザーコントロールの追加] を選択します。
LookupBox 領域に「」と入力し、[追加] を選択します。

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

LookupBox コントロールを設計する

LookupBox コントロールをデザインするには、ComboBoxからユーザーコントロールのデザインサーフェイスにをドラッグします。

必要なデータバインディング属性を追加する

データバインディングをサポートする参照コントロールの場合は、 LookupBindingPropertiesAttributeを実装できます。

LookupBox コントロールをコードビューに切り替えます。 ([ 表示 ] メニューの [ コード] を選択します)。

LookupBoxのコードを次のように置き換えます。

using System.Windows.Forms;

namespace CS
{
    [System.ComponentModel.LookupBindingProperties("DataSource", "DisplayMember", "ValueMember", "LookupMember")]
    public partial class LookupBox : UserControl
    {
        public object DataSource
        {
            get{ return comboBox1.DataSource; }
            set{ comboBox1.DataSource = value; }
        }

        public string DisplayMember
        {
            get{ return comboBox1.DisplayMember; }
            set{ comboBox1.DisplayMember = value; }
        }

        public string ValueMember
        {
            get{ return comboBox1.ValueMember; }
            set{ comboBox1.ValueMember = value; }
        }

        public string LookupMember
        {
            get{ return comboBox1.SelectedValue.ToString(); }
            set{ comboBox1.SelectedValue = value; }
        }


        public LookupBox()
        {
            InitializeComponent();
        }
    }
}

<System.ComponentModel.LookupBindingProperties("DataSource", "DisplayMember", "ValueMember", "LookupMember")>
Public Class LookupBox

    Public Property DataSource() As Object
        Get
            Return ComboBox1.DataSource
        End Get
        Set(ByVal value As Object)
            ComboBox1.DataSource = value
        End Set
    End Property

    Public Property DisplayMember() As String
        Get
            Return ComboBox1.DisplayMember
        End Get
        Set(ByVal value As String)
            ComboBox1.DisplayMember = value
        End Set
    End Property

    Public Property ValueMember() As String
        Get
            Return ComboBox1.ValueMember
        End Get
        Set(ByVal value As String)
            ComboBox1.ValueMember = value
        End Set
    End Property

    Public Property LookupMember() As String
        Get
            Return ComboBox1.SelectedValue.ToString()
        End Get
        Set(ByVal value As String)
            ComboBox1.SelectedValue = value
        End Set
    End Property
End Class

[ ビルド ] メニューの [ ソリューションのビルド] を選択します。

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

この手順では、Northwind サンプルデータベースのテーブルとCustomers テーブルに基づいて、Ordersウィザードを使用してデータソースを作成します。

[ データソース ] ウィンドウを開くには、[ データ ] メニューの [ データソースの表示] をクリックします。
[ データソース ] ウィンドウで、[ 新しいデータソースの追加 ] を選択して、 データソース構成 ウィザードを開始します。
[データソースの種類の選択] ページで、 [データベース] を選択し、 [次へ] を選択します。
[ データ接続の選択 ] ページで、次のいずれかの操作を行います。
- Northwind サンプルデータベースへのデータ接続がドロップダウンリストで使用できる場合は、それを選択します。
- [ 新しい接続] を選択して、[ 接続の追加/変更 ] ダイアログボックスを起動します。
データベースにパスワードが必要な場合は、機密データを含めるオプションを選択し、[ 次へ] を選択します。
[ アプリケーション構成ファイルへの接続文字列の保存 ] ページで、[ 次へ] をクリックします。
[ データベースオブジェクトの選択] ページで、[ テーブル ] ノードを展開します。
CustomersテーブルとOrdersテーブルを選択し、[完了] を選択します。

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

LookupBox コントロールを使用するように Orders テーブルの CustomerID 列を設定する

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

デザイナーで Form1 を開きます。
[データソース] ウィンドウで [顧客] ノードを展開します。
[注文] ノード (FAX 列の下にある [顧客] ノードのノード) を展開します。
[ 注文 ] ノードのドロップダウンリスト矢印をクリックし、コントロールリストから [詳細 ] を選択します。
[注文] ノードの [CustomerID] 列のドロップダウンリスト矢印をクリックし、[カスタマイズ] を選択します。
[データ UI カスタマイズオプション] ダイアログボックスの [関連付けられたコントロール] の一覧から LookupBox を選択します。
OK をクリックします。
CustomerID 列のドロップダウンリスト矢印をクリックし、[LookupBox] を選択します。

コントロールをフォームに追加する

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

Windows フォームでデータバインドコントロールを作成するには、[データソース] ウィンドウから Windows フォームに Orders ノードをドラッグし、LookupBox コントロールを使用してCustomerID列にデータが表示されることを確認します。

Customers テーブルから CompanyName を検索するようにコントロールをバインドする

参照バインドを設定するには、[データソース] ウィンドウでメインの [顧客] ノードを選択し、Form1 の CustomerIDLookupBox のコンボボックスにドラッグします。

これにより、CompanyName テーブルのCustomers値を維持しながら、CustomerID テーブルのOrdersを表示するようにデータバインディングが設定されます。

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

F5 押して、アプリケーションを実行します。
一部のレコード間を移動し、 CompanyName が LookupBox コントロールに表示されることを確認します。

Windows フォームコントロールを Visual Studio のデータにバインドする

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-12-12

次の方法で共有

参照データ バインディングをサポートする .NET Framework Windows フォーム ユーザー コントロールを作成する

[前提条件]

Windows フォーム アプリ プロジェクトを作成する

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