次の方法で共有


チュートリアル: XAML と C# を使用して Visual Studio で初めての Windows App SDK アプリケーションを作成する

この Visual Studio 統合開発環境 (IDE) の概要では、任意の Windows 10 以降のデバイスで実行される "Hello World" アプリを作成します。 これを行うには、Windows App SDK (WinUI 3) プロジェクト テンプレート、拡張アプリケーション マークアップ言語 (XAML)、および C# プログラミング言語を使用します。

手記

WinUI 3 は、 Windows App SDK に付属するネイティブ UI プラットフォーム コンポーネントです。 Windows SDK から完全に切り離されています。 詳細については、「WinUI 3 を参照してください。

前提 条件

  • このチュートリアルを完了するには、Visual Studio 2026 または Visual Studio 2022 の最新バージョンが必要です。 無料版については、 Visual Studio のダウンロードを参照してください。
  • WinUI と Windows App SDK を使用した開発に必要なワークロードとコンポーネント。 Visual Studio でワークロードを確認またはインストールするには、[ツール] >を選択します。 詳細については、「ワークロードまたは個々のコンポーネント変更する」を参照してください。

Visual Studio インストーラーの [ ワークロード ] タブで、次を選択します。

Windows App SDK を使用した C# アプリ開発の場合は、[ WinUI アプリケーション開発] を選択します。

Windows App SDK を使用した C# アプリ開発の場合は、[ WinUI アプリケーション開発] を選択します。

手記

Visual Studio 17.10 - 17.12 では、このワークロードは Windows アプリケーション開発と呼ばれます。

詳細については、「 Windows App SDK のインストール ツール」を参照してください。

プロジェクトを作成する

まず、WinUI 3 プロジェクトを作成します。 プロジェクトの種類には、何かを追加する前に、必要なすべてのテンプレート ファイルが付属しています。

  1. Visual Studio を開き、スタート ウィンドウで [新しいプロジェクト の作成]選択します。

  2. [ 新しいプロジェクトの作成 ] 画面で、検索ボックスに 「WinUI 」と入力し、 WinUI Blank App (Packaged) の C# テンプレートを選択して、[ 次へ] を選択します。

    [新しいプロジェクトの作成] ダイアログのスクリーンショット。検索ボックスに 「WinUI」と入力され、WinUI 空のアプリ (パッケージ化) プロジェクト テンプレートが強調表示されています。

  3. プロジェクトに HelloWorldという名前を付け、作成を選択します。

    [プロジェクト名] フィールドに 「HelloWorld」と入力された [新しいプロジェクトの構成] ダイアログのスクリーンショット。

  1. Visual Studio を開き、スタート ウィンドウで [新しいプロジェクト の作成]選択します。

  2. [ 新しいプロジェクトの作成 ] 画面で、検索ボックスに 「winui 」と入力し、 空のアプリの C# テンプレートの C# テンプレート、パッケージ (デスクトップの WinUI 3) を選択し、[ 次へ] を選択します。

    Visual Studio 2022 の [新しいプロジェクトの作成] ダイアログのスクリーンショット。検索ボックスに

  3. プロジェクトに HelloWorldという名前を付け、作成を選択します。

    Visual Studio 2022 の [新しいプロジェクトの構成] ダイアログのスクリーンショット。[プロジェクト名] フィールドに 「HelloWorld」と入力されています。

手記

この記事が Visual Studio を初めて使用して Windows App SDK アプリを作成する場合は、[ 設定] ダイアログが表示されることがあります。 [開発者モード ] を選択し、次に [はい ] を選択します。

開発者モードを有効にするオプションを含む [設定] ダイアログを示すスクリーンショット。

Visual Studio によって、別の開発者モード パッケージがインストールされます。 パッケージのインストールが完了したら、[ 設定] ダイアログを閉じます。

アプリケーションを作成する

開発を始めましょう。 ここでは、ボタン コントロールを追加し、ボタンにアクションを追加してから、 Hello World アプリを実行して外観を確認します。

デザイン キャンバスにボタンを追加する

  1. ソリューション エクスプローラーで、MainWindow.xaml ダブルクリックして XAML マークアップ エディターを開きます。

    [ソリューション エクスプローラー] ウィンドウのスクリーンショット。HelloWorld プロジェクトのプロパティ、参照、アセット、ファイルが表示され、MainWindow.xaml ファイルが選択されています。

    XAML エディター では、マークアップを追加または変更できます。 UWP プロジェクトとは異なり、WinUI 3 には デザイン ビューはありません。

    Visual Studio IDE で開いている MainWindow.xaml を示すスクリーンショット。[XAML エディター] ウィンドウには、ウィンドウの XAML マークアップが表示されます。

  2. <Grid>項目内で、<Buttonの入力を開始します。 Intellisense にはボタン オプションが用意されています。 Tab キーを押して同意します。

    XAML エディターで [ボタン] が強調表示されているスクリーンショット。

  1. ソリューション エクスプローラーで、MainWindow.xaml ダブルクリックして XAML マークアップ エディターを開きます。

    Visual Studio 2022 のソリューション エクスプローラー ウィンドウのスクリーンショット。HelloWorld プロジェクトのプロパティ、参照、アセット、ファイルが示され、MainWindow.xaml ファイルが選択されています。

    XAML エディター では、マークアップを追加または変更できます。 UWP プロジェクトとは異なり、WinUI 3 には デザイン ビューはありません。

    Visual Studio 2022 IDE で開いている MainWindow.xaml を示すスクリーンショット。[XAML エディター] ウィンドウには、ウィンドウの XAML マークアップが表示されます。

  2. ウィンドウのルートにある StackPanel にネストされた Button コントロールをレビューします。

    XAML エディターで [ボタン] が強調表示されているスクリーンショット。

ボタンのラベルを変更する

  1. XAML エディターで、Button Content の値を現在の値から "Hello World!" に変更します。

    XAML エディターの Button の XAML コードを示すスクリーンショット。Content プロパティの値が Hello World に変更されました。

  2. <Button>要素の開始タグ (Content など、既存の属性の後) にカーソルを置き、「クリック」と入力します。 Intellisense には、Button_Clickと呼ばれる新しいイベント ハンドラーが用意 されます。 次のセクションでは、そのコードを操作します。

    ボタンのクリック イベントが強調表示されている XAML エディターの Button の XAML コードを示すスクリーンショット。

  1. XAML エディターで、Button Content の値を現在の値から "Hello World!" に変更します。

    Visual Studio 2022 の XAML エディターの Button の XAML コードを示すスクリーンショット。Content プロパティの値が Hello World に変更されました。

  2. ボタンに Click イベント ハンドラー myButton_Click 指定されていることにも注意してください。 次の手順では、この操作を行います。

    Visual Studio 2022 の XAML エディターの Button の XAML コードを示すスクリーンショット。ボタンのクリック イベントが強調表示されています。

イベント ハンドラーを変更する

イベント ハンドラー 複雑に思われますが、イベントが発生したときに呼び出されるコードの名前にすぎません。 この場合、Hello World によってトリガーされるアクションが追加されます。 ボタン

  1. ソリューション エクスプローラー で、コードビハインド ページの MainWindow.xaml.csをダブルクリックします。

  2. 開いた C# エディター ウィンドウでイベント ハンドラー コードを編集します。

    ここで興味深い情報が得られます。 既定のイベント ハンドラーは次のようになります。

    既定のButton_Click イベント ハンドラーの C# コードを示すスクリーンショット。

    これを変更してみましょう。次のようになります。

    新しい非同期myButton_Click イベント ハンドラーの C# コードを示すスクリーンショット。

    コピーして貼り付けるコードを次に示します。

    private async void Button_Click(object sender, RoutedEventArgs e)
    {
        var welcomeDialog = new ContentDialog()
        {
            Title = "Hello from HelloWorld",
            Content = "Welcome to your first Windows App SDK app.",
            CloseButtonText = "Ok",
            XamlRoot = ((FrameworkElement)sender).XamlRoot
        };
        await welcomeDialog.ShowAsync();
    }
    
  1. ソリューション エクスプローラー で、コードビハインド ページの MainWindow.xaml.csをダブルクリックします。

  2. 開いた C# エディター ウィンドウでイベント ハンドラー コードを編集します。

    ここで興味深い情報が得られます。 既定のイベント ハンドラーは次のようになります。

    Visual Studio 2022 の既定のButton_Click イベント ハンドラーの C# コードを示すスクリーンショット。

    これを変更してみましょう。次のようになります。

    Visual Studio 2022 の新しい非同期myButton_Click イベント ハンドラーの C# コードを示すスクリーンショット。

    コピーして貼り付けるコードを次に示します。

    private async void myButton_Click(object sender, RoutedEventArgs e)
    {
        var welcomeDialog = new ContentDialog()
        {
            Title = "Hello from HelloWorld",
            Content = "Welcome to your first Windows App SDK app.",
            CloseButtonText = "Ok",
            XamlRoot = myButton.XamlRoot
        };
        await welcomeDialog.ShowAsync();
    }
    

私たちは何をしましたか?

このコードでは、ContentDialog コントロールを使用して、現在のウィンドウ内のモーダル ポップアップ コントロールにウェルカム メッセージを表示します。 Microsoft.UI.Xaml.Controls.ContentDialogの使用方法の詳細については、「ContentDialog クラス」を参照してください。

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

次に、Hello World Windows App SDK アプリをビルド、デプロイ、起動して、その外観を確認します。 その方法を次に示します。

  1. [再生] ボタンを使用して、ローカル コンピューターでアプリケーションを起動します。 HelloWorld (パッケージ) というテキストが含まれています。

    [再生] ボタンの横にあるドロップダウン ボックスが開き、[HelloWorld (パッケージ)]が選択されているスクリーンショット。

    または、メニュー バーから [デバッグ] >選択するか、F5 キー 押してアプリを起動することもできます。

  2. スプラッシュ画面が消えた直後に表示されるアプリを表示します。 アプリは次の画像のようになります。

    実行中の Windows App SDK 'Hello World' アプリケーションを示すスクリーンショット。

  3. Hello World ボタンを選択します。

    Windows 10 以降のデバイスには、"Hello from HelloWorld" というタイトルの "最初の Windows App SDK アプリへようこそ" というメッセージが表示されます。[ OK] を 選択してメッセージを閉じます。

    実行中の

  4. アプリを閉じるには、ツール バーの [デバッグの停止] ボタンを選択します。 または、メニュー バーから [デバッグ>ストップ デバッグ ] を選択するか、 Shift キーを押しながら F5 キーを押します。

このチュートリアルを完了しておめでとうございます。 Windows App SDK、WinUI 3、および Visual Studio IDE に関するいくつかの基本を学習していただければ幸いです。 詳細については、次のチュートリアルに進んでください。

チュートリアル: WinUI 3 を使用して簡単なフォト ビューアーを作成する

これらのリソースは、次の場合にも役立ちます。