フォーム間でデータを渡す

注

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

このチュートリアルでは、フォーム間でデータを渡す手順について説明します。 Northwind サンプルデータベースの Customers テーブルと Orders テーブルを使用すると、1 つのフォームでユーザーが顧客を選択でき、2 つ目のフォームに選択した顧客の注文が表示されます。このチュートリアルでは、最初のフォームからデータを受け取る 2 番目のフォームでメソッドを作成する方法について説明します。

このチュートリアルでは、次のタスクを実行します。

新しい Windows フォームアプリ (.NET Framework) プロジェクトを 作成します。
データソース構成ウィザードを使用してデータセットを作成および構成します。
[ データソース] ウィンドウから項目をドラッグするときに、フォームに作成するコントロールを選択します。詳細については、「データソース」ウィンドウからドラッグするときに作成するコントロールを設定するを参照してください。
データソース ウィンドウからフォームに項目をドラッグして、データバインドコントロールを作成します。
データを表示するグリッドを使用して 2 つ目のフォームを作成します。
特定の顧客の注文をフェッチする TableAdapter クエリを作成します。
フォーム間でデータを渡します。

注

このチュートリアルでは、フォーム間でデータを渡す方法を 1 つだけ示します。データを受け取る 2 番目のコンストラクターの作成や、最初のフォームのデータで設定できるパブリックプロパティの作成など、フォームにデータを渡すための他のオプションがあります。

[前提条件]

Visual Studio にインストールされている .NET デスクトップ開発およびデータストレージと処理ワークロード。インストールするには、 Visual Studio インストーラー を開き、使用する Visual Studio のバージョンの横にある [変更] または [ その他>Modify] を選択します。詳細については、「 Visual Studio の変更」を参照してください。
SQL Server Express 2019 LocalDB は、SQL Server のダウンロードページから、またはデータストレージと処理ワークロードの一部として Visual Studio インストーラーを使用してインストールされます。
Northwind サンプルデータベース。次の手順に従って作成されます。
1. Visual Studio で、[表示] メニューから SQL Server オブジェクトエクスプローラー ウィンドウを選択して開きます。 SQL Server オブジェクトエクスプローラーは、 データストレージと処理 ワークロードの一部としてインストールされます。
2. SQL Server ノードを展開し、LocalDB インスタンスを右クリックし、[新しいクエリ] を選択してクエリエディターウィンドウを開きます。
3. Northwind Transact-SQL スクリプトをクリップボードにコピーします。この T-SQL スクリプトは、Northwind データベースを作成し、データを設定します。
4. T-SQL スクリプトをクエリエディターに貼り付け、ウィンドウの上部にある [実行 ] を選択して Northwind データベースを作成します。

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

Visual Studio の [ファイル] メニューで､ [新規作成]>[プロジェクト] を選択します。
[すべての言語] ドロップダウンリストから C# または Visual Basic を選択し、[すべてのプラットフォーム] ドロップダウンリストから Windows を選択し、[すべてのプロジェクトの種類] リストから [デスクトップ] を選択します。
プロジェクトテンプレートの一覧から Windows フォームアプリ (.NET Framework) を選択し、[ 次へ] を選択します。
PassingDataBetweenForms プロジェクトに名前を付け、[次へ] を選択して、[作成] を選択します。

PassingDataBetweenForms プロジェクトが作成され、ソリューションエクスプローラーに追加されます。 Form1 のデザイナービューがエディターに表示されます。

データソースの作成

Visual Studio メニューの [プロジェクト>新しいデータソースの追加] を選択して、[データソース] ウィンドウを開きます。
[ データソース ] ウィンドウで、[ 新しいデータソースの追加 ] を選択して、 データソース構成 ウィザードを開始します。
[ データソースの種類の選択 ] ページで、[ データベース] を選択し、[ 次へ] を選択します。
[ データベースモデルの選択 ] ページで、 データセット が指定されていることを確認し、[ 次へ] を選択します。
[ データ接続の選択 ] ページで、Northwind サンプルデータベースへのデータ接続が既に使用可能な場合は、それを選択し、[ データベースオブジェクトの選択] ステップに進みます。接続済みの接続を選択しなかった場合は、 [新しい接続] を選択します。
[ データソースの選択 ] 画面で、[ Microsoft SQL Server データベースファイル] を選択し、[ 続行] を選択します。
[ 接続の追加 ] 画面で、[ 参照] を選択し、 northwnd.mdf ファイルを参照して選択し、[ 開く] を選択します。
[Windows 認証] を選択するか、[SQL Server 認証] を選択し、データベースにアクセスするためのユーザー名とパスワードを指定します。
[テスト接続] を選んで接続をテストします。接続が成功したら、[ OK] を選択します。
[ データ接続の選択 ] ページで、データベースファイルが表示されていることを確認し、[ 次へ] を選択します。
ポップアップの質問で [いいえ ] を選択します 。ファイルをプロジェクトにコピーして接続を変更しますか?
[ アプリケーション構成ファイルへの接続文字列の保存] ページで、[ はい] を選択します。接続に NorthwindConnectionString という名前を付け、[ 次へ] を選択します。
[ データベースオブジェクトの選択 ] ページで、[ テーブル ] ノードを展開し、[ 顧客と注文 ] テーブルを選択し、データセットに NorthwindDataSet という名前を付け、[ 完了] を選択します。

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

最初のフォームにデータを入力する

データバインドグリッドを作成するには、[データ ソース] ウィンドウから Form1 に [顧客] ノードをドラッグします。

DataGridView コントロールとレコード内を移動するためのBindingNavigator ツールストリップが Form1 に表示されます。 NorthwindDataSet、CustomersTableAdapter、BindingSource、およびBindingNavigatorがコンポーネントトレイに表示されます。

2 番目のフォームを作成する

データを渡す 2 つ目のフォームを作成します。

[プロジェクト] メニューの [フォームの追加 ] (Windows フォーム) を選択します。
既定の Form2 名のままにして、[追加] を選択します。
メインの Orders ノードを [ データソース] ウィンドウから Form2 にドラッグします。

レコード内を移動するための DataGridView と BindingNavigator ツールストリップが Form2 に表示されます。 NorthwindDataSet、CustomersTableAdapter、BindingSource、およびBindingNavigatorがコンポーネントトレイに表示されます。
コンポーネントトレイから OrdersBindingNavigator を削除します。 BindingNavigator がForm2 から消えます。

TableAdapter クエリを追加する

Form1 で選択した顧客の注文を読み込む TableAdapter クエリを Form2 に追加します。

ソリューションエクスプローラーで NorthwindDataSet.xsd ファイルをダブルクリックします。
Orders テーブルで OrdersTableAdapter を右クリックし、[追加>Query] を選択します。
[ SQL ステートメントを使用 する] の既定のオプションのままにして、[ 次へ] を選択します。
行を返す SELECT の既定のオプションのままにして、[次へ] を選択します。
テーブルを読み込む必要があるデータで、Ordersに基づいてCustomerIDを返すには、クエリの末尾にWHERE句を追加します。最終的なクエリは、次のコードのようになります。
```
SELECT OrderID, CustomerID, OrderDate, RequiredDate, ShippedDate, ShipVia, Freight, ShipName, ShipAddress, ShipCity, ShipRegion, ShipPostalCode, ShipCountry
FROM Orders
WHERE CustomerID = @CustomerID
```
注

データベースの正しいパラメーター構文を使用します。たとえば、Microsoft Access では、 WHERE 句は WHERE CustomerID = ?のようになります。
[次へ] を選択します。
生成するメソッドの選択画面で、DataTable を埋めるを選択し、FillByCustomerIDと入力します。
[ DataTable を返す ] オプションの選択を解除し、[ 完了] を選択します。

Form2 でデータを渡すメソッドを作成する

Form2 で右クリックし、[コードの表示] を選択して、エディターで Form2 コードを開きます。
Form2 コードで、Form2_Load メソッドの内容を削除し、Form2_Load メソッドの後に次のコードを追加します。

internal void LoadOrders(String CustomerID)
{
    ordersTableAdapter.FillByCustomerID(northwindDataSet.Orders, CustomerID);
}

Friend Sub LoadOrders(ByVal CustomerID As String)
    OrdersTableAdapter.FillByCustomerID(NorthwindDataSet.Orders, CustomerID)
End Sub

Form1 でデータを渡して Form2 を表示するメソッドを作成する

Form1 のデザイナービューで、[顧客データ] グリッドを右クリックし、[プロパティ] を選択します。
[ プロパティ ] ウィンドウで、上部のツールバーの [イベント ] アイコンを選択します。
DoubleClick イベントをダブルクリックして、コードエディターを開きます。
コードエディターで、次のサンプルに一致するようにメソッド定義を更新します。

private void customersDataGridView_DoubleClick(object sender, EventArgs e)
{
    System.Data.DataRowView SelectedRowView;
    NorthwindDataSet.CustomersRow SelectedRow;

    SelectedRowView = (System.Data.DataRowView)customersBindingSource.Current;
    SelectedRow = (NorthwindDataSet.CustomersRow)SelectedRowView.Row;

    Form2 OrdersForm = new Form2();
    OrdersForm.LoadOrders(SelectedRow.CustomerID);
    OrdersForm.Show();
}

Private Sub CustomersDataGridView_DoubleClick() Handles CustomersDataGridView.DoubleClick

    Dim SelectedRowView As Data.DataRowView
    Dim SelectedRow As NorthwindDataSet.CustomersRow

    SelectedRowView = CType(CustomersBindingSource.Current, System.Data.DataRowView)
    SelectedRow = CType(SelectedRowView.Row, NorthwindDataSet.CustomersRow)

    Dim OrdersForm As New Form2
    OrdersForm.LoadOrders(SelectedRow.CustomerID)
    OrdersForm.Show()
End Sub

アプリを実行してテストする

F5 押して、アプリケーションを実行します。
アプリケーションで、 Form1 の顧客レコードをダブルクリックして、その顧客の注文を含む Form2 を開きます。

次のステップ

アプリケーションの要件に応じて、フォーム間でデータを渡した後、いくつかの手順を実行できます。このチュートリアルでは、次のような機能強化を行うことができます。

データベースオブジェクトを追加または削除するためのデータセットの編集。詳細については、「データセットの作成と構成」を参照してください。
データをデータベースに保存する機能を追加しました。詳細については、「データをデータベースに保存する」を参照してください。

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

フィードバック

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

Last updated on 2025-08-07