チュートリアル: .NET を使用して Windows フォーム アプリを作成する
このチュートリアルでは、Visual Studio を使用して新しいWindows フォーム アプリを作成する方法について説明します。 Visual Studio では、フォームにコントロールを追加し、イベントを処理します。 このチュートリアルを完了すると、リスト ボックスに名前を追加する簡単なアプリが作成されます。
このチュートリアルでは、次の作業を行いました。
- 新しい Windows フォーム アプリを作成する
- フォームにコントロールを追加する
- コントロール イベントを処理してアプリの機能を提供する
- アプリを実行する
前提条件
注意事項
.NET 6 はサポートされなくなりました。 .NET 9.0 を使用することをお勧めします。
注意事項
.NET 7 はサポートされなくなりました。 .NET 9.0 を使用することをお勧めします。
Windows フォーム アプリを作成する
新しいアプリを作成するための最初のステップは、Visual Studio を開き、テンプレートからアプリを生成することです。
注意事項
.NET 6 はサポートされなくなりました。 .NET 9.0 を使用することをお勧めします。
Visual Studio を開きます。
[新しいプロジェクトの作成] を選択します。
[テンプレートの検索] ボックスに「winforms」と入力し、検索結果が表示されるのを待ちます。
[コード言語] ドロップダウンで、 [C#] または [Visual Basic] を選択します。
テンプレートの一覧で [アプリWindows フォーム選択し次へを選択。
重要
Windows フォーム アプリ (.NET Framework) テンプレートは選択しないでください。
次の図は、C# と Visual Basic の両方の .NET プロジェクト テンプレートを示しています。 code 言語フィルターを適用した場合は、対応するテンプレートが一覧表示されます。
新しいプロジェクトの構成 ウィンドウで、プロジェクト名を Names に設定し、 Next を選択します。
[場所] のパスを調整することで、プロジェクトを別のフォルダーに保存することもできます。
最後に、追加情報 ウィンドウで、Framework 設定の .NET 6.0 (長期サポート)を選択し、Create を選択します。
注意事項
.NET 7 はサポートされなくなりました。 .NET 9.0 を使用することをお勧めします。
Visual Studio を開きます。
[新しいプロジェクトの作成] を選択します。
[テンプレートの検索] ボックスに「winforms」と入力し、検索結果が表示されるのを待ちます。
[コード言語] ドロップダウンで、 [C#] または [Visual Basic] を選択します。
テンプレートの一覧で [アプリWindows フォーム選択し次へを選択。
重要
Windows フォーム アプリ (.NET Framework) テンプレートは選択しないでください。
次の図は、C# と Visual Basic の両方の .NET プロジェクト テンプレートを示しています。 code 言語フィルターを適用した場合は、対応するテンプレートが一覧表示されます。
新しいプロジェクトの構成 ウィンドウで、プロジェクト名を Names に設定し、 Next を選択します。
[場所] のパスを調整することで、プロジェクトを別のフォルダーに保存することもできます。
最後に、追加情報 ウィンドウで、Framework 設定の .NET 7.0 (Standard Term Support)を選択し、Create を選択します。
Visual Studio を開きます。
[新しいプロジェクトの作成] を選択します。
[テンプレートの検索] ボックスに「winforms」と入力し、検索結果が表示されるのを待ちます。
[コード言語] ドロップダウンで、 [C#] または [Visual Basic] を選択します。
テンプレートの一覧で [アプリWindows フォーム選択し次へを選択。
重要
Windows フォーム アプリ (.NET Framework) テンプレートは選択しないでください。
次の図は、C# と Visual Basic の両方の .NET プロジェクト テンプレートを示しています。 code 言語フィルターを適用した場合は、対応するテンプレートが一覧表示されます。
新しいプロジェクトの構成 ウィンドウで、プロジェクト名を Names に設定し、 Next を選択します。
[場所] のパスを調整することで、プロジェクトを別のフォルダーに保存することもできます。
最後に、追加情報 ウィンドウで、Framework 設定の .NET 8.0 (長期サポート)を選択し、Create を選択します。
Visual Studio を開きます。
[新しいプロジェクトの作成] を選択します。
[テンプレートの検索] ボックスに「winforms」と入力し、検索結果が表示されるのを待ちます。
[コード言語] ドロップダウンで、 [C#] または [Visual Basic] を選択します。
テンプレートの一覧で [アプリWindows フォーム選択し次へを選択。
重要
Windows フォーム アプリ (.NET Framework) テンプレートは選択しないでください。
次の図は、C# と Visual Basic の両方の .NET プロジェクト テンプレートを示しています。 code 言語フィルターを適用した場合は、対応するテンプレートが一覧表示されます。
新しいプロジェクトの構成 ウィンドウで、プロジェクト名を Names に設定し、 Next を選択します。
[場所] のパスを調整することで、プロジェクトを別のフォルダーに保存することもできます。
最後に、追加情報 ウィンドウで、Framework 設定の .NET 9.0 (Standard Term Support)を選択し、Create を選択します。
アプリが生成されると、Visual Studio で既定のフォーム Form1 のデザイナー ウィンドウが開きます。 フォーム デザイナーが表示されない場合は、ソリューション エクスプローラー ウィンドウでフォームをダブルクリックしてデザイナー ウィンドウを開きます。
Visual Studio の重要な部分
Visual Studio でのWindows フォームのサポートには、アプリの作成時に対話する 4 つの重要なコンポーネントがあります。
ソリューション エクスプローラー
すべてのプロジェクト ファイル、コード、フォーム、リソースがこのウィンドウに表示されます。
プロパティ
このウィンドウには、選択した項目のコンテキストに基づいて構成できるプロパティ設定が表示されます。 たとえば、ソリューション エクスプローラーから項目を選択すると、ファイルに関連する設定が表示されます。 Designer内のオブジェクトが選択されている場合は、コントロールまたはフォームのプロパティが表示されます。
フォーム デザイナー
これは、フォーム用のデザイナーです。 対話型であり、 [ツールボックス] からオブジェクトをドラッグ アンド ドロップすることができます。 デザイナーで項目を選択して移動することにより、アプリのユーザー インターフェイス (UI) を視覚的に作成できます。
ツールボックス
ツールボックスには、フォームに追加できるすべてのコントロールが含まれています。 現在のフォームにコントロールを追加するには、コントロールをダブルクリックするか、コントロールをドラッグ アンド ドロップします。
ヒント
ツールボックスが表示されない場合は、[表示]>[ツールボックス] メニュー項目を使って表示できます。
コントロールをフォームに追加する
Form1 フォーム デザイナーを開いた状態で、Toolbox ウィンドウを使用して、ツールボックスからコントロールをドラッグしてフォームにドロップすることで、次のコントロールをフォームに追加します。
- Button
- Label
- Listbox
- テキストボックス
次の図に従ってコントロールの位置とサイズを設定します。
マウスを使用してコントロールを移動およびサイズ変更して前の画像と一致させるか、次の表を使用して各コントロールを構成できます。 コントロールを構成するには、デザイナーでコントロールを選択し、 Properties ウィンドウで適切な設定を設定します。 フォームを構成するときに、フォームのタイトル バーを選択します。
Object | 設定 | Value |
---|---|---|
ラベル | 場所 | 12, 9 |
Text | Names |
|
Listbox | 名前 | lstNames |
場所 | 12, 27 |
|
サイズ | 120, 94 |
|
テキスト ボックス | 名前 | txtName |
場所 | 138, 26 |
|
サイズ | 100, 23 |
|
Button | 名前 | btnAdd |
場所 | 138, 55 |
|
サイズ | 100, 23 |
|
Text | Add Name |
|
フォーム | Text | Names |
サイズ | 268, 180 |
イベントを処理する
フォームにすべてのコントロールがレイアウトされたので、次の手順では、ユーザー入力に応答するイベント ハンドラーを追加します。 フォーム デザイナーに移動し、次の手順を実行します。
フォームの [名前の追加 ] ボタン コントロールを選択します。
Properties ウィンドウで、イベント アイコン を選択して、ボタンのイベントを一覧表示します。
Click イベントを見つけてダブルクリックし、イベント ハンドラーを生成します。
このアクションにより、次のコードがフォームに追加されます。
private void btnAdd_Click(object sender, EventArgs e) { }
Private Sub btnAdd_Click(sender As Object, e As EventArgs) Handles btnAdd.Click End Sub
このハンドラーのコードは、
txtName
テキスト ボックスで指定された名前をlstNames
リスト ボックスに追加します。 ただし、名前の追加に 2 つの条件を設けます。指定された名前が空白であってはならず、名前が既に存在していてはなりません。次のコードでは、名前を
lstNames
コントロールに追加する方法を示します。private void btnAdd_Click(object sender, EventArgs e) { if (!string.IsNullOrWhiteSpace(txtName.Text) && !lstNames.Items.Contains(txtName.Text)) lstNames.Items.Add(txtName.Text); }
Private Sub btnAdd_Click(sender As Object, e As EventArgs) Handles btnAdd.Click If Not String.IsNullOrWhiteSpace(txtName.Text) And Not lstNames.Items.Contains(txtName.Text) Then lstNames.Items.Add(txtName.Text) End If End Sub
アプリを実行する
イベントが処理されたので、 F5 キーを押すか、メニューから Debug>Start Debugging を選択してアプリを実行します。 アプリが起動すると、フォームが表示され、テキスト ボックスに名前を入力してボタンを選択できます。
関連するコンテンツ
.NET Desktop feedback