次の方法で共有

WinForms アプリでの WebView2 の概要

  • [アーティクル]

この記事では、独自の WebView2 コードを記述する方法について説明します。 最初にサンプルを実行する場合は、 Win32 サンプル アプリまたは WinForms サンプル アプリ などの別 のサンプル アプリに関する記事を参照してください。

このチュートリアルは、次の場合に役立ちます。

  • 開発ツールを設定します。
  • C# Windows フォーム App (.NET Framework) Visual Studio プロジェクト テンプレートを使用して、WinForms プロジェクトを作成します。
  • WinForms プロジェクトの Microsoft.Web.WebView2 SDK パッケージをインストールします。
  • 途中で WebView2 の概念について説明します。

手順 1 - 必要に応じて WebView2Samples リポジトリを複製またはダウンロードする

次のいずれかの操作を行います。

  • 次のセクションの手順を使用して、プロジェクト テンプレートから開始して Visual Studio で新しいプロジェクトを作成します。 これにより、最新のコードとプロジェクト構造が提供されます。

  • WebView2Samples リポジトリを複製またはダウンロードし、Visual Studio で完成したプロジェクトを開き、この記事の手順に従って WinForms プロジェクトの作成を理解し、追加された WebView2 コードを理解します。 「WebView2 の開発環境をセットアップする」の「WebView2Samples リポジトリをダウンロードする」を参照してください。 このチュートリアル プロジェクトの完成したバージョンは、WebView2Samples リポジトリ ディレクトリ WinForms_GettingStartedで入手できます。

    • サンプル名: Win32_GettingStarted
    • リポジトリ ディレクトリ: Win32_GettingStarted
    • ソリューション ファイル: WebView2GettingStarted.sln

リポジトリ内のサンプルは、最新の Visual Studio プロジェクト テンプレートを使用して作成したプロジェクトほど最新ではない可能性があります。

手順 2 - Visual Studio をインストールする

Microsoft Visual Studio が必要です。 このチュートリアルでは、Microsoft Visual Studio Code はサポートされていません。

  1. Visual Studio がまだインストールされていない場合は、新しいウィンドウまたはタブで Microsoft Visual Studio ページを開き、Visual Studio 2022 Professional などの Visual Studio 2017 以降をインストールします。

    次に、ここに戻り、以下に進みます。

手順 3 - 単一ウィンドウ アプリを作成する

1 つのメイン ウィンドウを含む基本的なデスクトップ プロジェクトから開始します。

  1. Visual Studio を開きます。

  2. [ファイル]>[新規作成]>[プロジェクト] の順に選択します。

    Visual Studio の [ 最近使ったウィンドウを開く ] ウィンドウが表示されます。

    Visual Studio の開くパネルには、[新しいプロジェクトの作成] カード

  3. 右側の [新しいプロジェクトの作成] カードをクリックします。 Visual Studio の [新しいプロジェクトの作成 ] ウィンドウが開きます。

  4. [ 検索 ] テキスト ボックスに、次のように貼り付けるか、入力を開始します。

    C# Windows Forms App (.NET Framework)

    検索結果が表示され、プロジェクトの種類が一覧表示されます。

  5. C# Windows フォーム App (.NET Framework) カードを選択します。 名前が C# アイコンで一致し、名前が App (.NET Framework) Windows フォームであることを確認します。 次に、[ 次へ ] ボタンをクリックします。

    [新しいプロジェクトの作成] パネルで、'C# > Windows フォーム App (.NET Framework)' を選択します

  6. [ プロジェクト名 ] テキスト ボックスに、プロジェクト名を入力します。 このチュートリアル記事では、完了したプロジェクトのリポジトリのディレクトリ名のように、WinForms_GettingStartedという名前を使用します。

  7. [ 場所 ] テキスト ボックスに、"C:\Users\username\Documents\MyWebView2Projects" などのパスを入力します。

  8. [フレームワーク] ドロップダウン リストで、.NET Framework 4.8 など、.NET Framework 4.7.2 以降を選択します。

    [新しいプロジェクトの構成] ウィンドウに入力する

  9. [作成] ボタンをクリックします。

    Visual Studio ウィンドウが開き、ソリューション エクスプローラーのベースライン WinForms プロジェクトが表示され、フォーム Designer ウィンドウが表示されます。

    Visual Studio ウィンドウに、ベースライン WinForms プロジェクトとForms Designerが表示されます。

  10. [ファイル] >[すべて保存] (Ctrl + Shift + S) を選択します。

  11. [ デバッグ>デバッグの開始 (F5)] を選択します。

    新しい WinForms プロジェクトから空の Form1 ウィンドウが開きます。

    新しい WinForms プロジェクトの空の Form1 ウィンドウ

  12. Form1 ウィンドウを閉じます。

これで、実行される空の WinForms プロジェクトが作成されました。 次に、WebView2 コンテンツを追加するようにプロジェクトを設定します。

手順 4 - WebView2 SDK をインストールする

WebView2 プロジェクトごとに、Visual Studio 内の NuGet パッケージ マネージャーを使用して、WebView2 SDK をプロジェクトに追加します。 現在のプロジェクトで使用するために 、Microsoft.Web.WebView2 SDK NuGet パッケージをインストールします。

NuGet を使用して、次のように WebView2 SDK をプロジェクトに追加します。

  1. ソリューション エクスプローラーで、(その上のソリューション名ではなく) プロジェクト名を右クリックし、[NuGet パッケージの管理] を選択します。

    NuGet パッケージを管理する

    Visual Studio で NuGet パッケージ マネージャーが開きます。

  2. 左上の [ 参照 ] タブをクリックします。

  3. [ プレリリースを含める ] チェック ボックスをオフにします。

  4. 検索バーに 「WebView2」と入力し、検索バーの下にある [Microsoft.Web.WebView2 ] をクリックして選択します。

    現在のプロジェクトの Microsoft.Web.WebView2 SDK NuGet パッケージをインストールする Visual Studio の NuGet パッケージ マネージャー

    ズームするには、[ >新しいタブで画像を開く] を右クリックします。

  5. [ インストール ] (または [更新]) ボタンをクリックします。 [ 変更のプレビュー ] ダイアログが開きます。

    [変更のプレビュー] ダイアログ

  6. [OK] ボタンをクリック します 。

  7. [ ファイル>すべて保存 (Ctrl + Shift + S) を選択してプロジェクトを保存します。

  8. [NuGet パッケージ マネージャー] ウィンドウを閉じます。

  9. [ デバッグ>デバッグの開始 (F5) を選択して、プロジェクトをビルドして実行します。

    実行中のプロジェクトには、以前と同じ空のウィンドウが表示されます。

    新しい WinForms プロジェクトの空の Form1 ウィンドウ

  10. Form1 ウィンドウを閉じます。

WebView2 SDK をプロジェクトに追加しましたが、まだ WebView2 コードをプロジェクトに追加していません。

手順 5 - 単一の WebView2 コントロールを作成する

WinForms プロジェクトに WebView2 SDK がインストールされたら、次のように WebView2 コントロールをアプリに追加します。

スターター プロジェクトには既に Form1.cs フォームがありますが、その方法を確認するために、 Form2.csとして別のフォームを追加します。

  1. [プロジェクト>フォームの追加 (Windows フォーム)) を選択します。

  2. [新しい項目の追加] ウィンドウの左側にある [Visual C# Items>Windows フォーム] を選択します。

  3. 右側の [フォーム (Windows フォーム)] を選択し、[追加] ボタンをクリックします。

    [新しい項目の追加] ウィンドウが [Visual C# Items] > 'Windows フォーム' に展開され、[フォーム (Windows フォーム)] を選択します。

    プロジェクトに追加のフォームが追加され、ファイル名がForm2.csされ、[フォーム] Designerとソリューション エクスプローラーに表示されます。

    追加されたフォーム (Form2.cs)、フォーム Designer、および ソリューション エクスプローラー

  4. Form1 キャンバスをクリックします。 Form2 は使用しません。

  5. [ 表示>Toolbox] を選択します。

    WebView2 固有のコンテンツをアプリに追加する場所を次に示します。

  6. [ツールボックス] で、[WebView2 Windows フォーム コントロール] をクリックしてオプションを展開します。

    Visual Studio 2017 では、既定では、 WebView2 は ツールボックスに表示されません。 WebView2 をツールボックスに表示できるようにするには、[ツール>Options>General> を選択し、[ツールボックスの自動設定] 設定を True に設定します。

  7. [ツールボックス] で、追加したコントロールのForms Designer キャンバスに WebView2 コントロールをクリックまたはドラッグします (例: Form2.cs)。

    WebView2 を表示するツールボックス

  8. WebView2 コントロールの辺をドラッグして、ほぼすべてのキャンバスに塗りつぶします。

  9. フォームの新しい WebView2 コントロールが選択されていることを確認します。 [ プロパティ ] パネルの [ デザイン ] セクションで、 (Name) プロパティを webView (小文字の 'w'、大文字 'V'、数値サフィックスなし) に設定します。 コントロールには、最初は webView21 などの別の名前が付けられている場合があります。 プロパティを検索するには、必要に応じて [ 分類] および [ アルファベット順 ] 並べ替えオプション ボタンを使用します。

    WebView2 コントロールのプロパティ

  10. [ プロパティ ] パネルの [ その他 ] セクションで、[ ソース ] プロパティを [ https://www.microsoft.com] に設定します。 Source プロパティは、WebView2 コントロールに表示される初期 URL を設定します。

  11. [ ファイル>すべて保存 (Ctrl + Shift + S) を選択してプロジェクトを保存します。

  12. F5 キーを押して、プロジェクトをビルドして実行します。

    WebView2 コントロールは、https://www.microsoft.comのコンテンツをWindows フォーム フォームの WebView2 コントロールに表示し、Alt キーを押しながら Tab キーを押してウィンドウに切り替えた場合は、[コンテンツへのスキップ] リンクをメインします。

    Alt + Tab キーを押すと、サンプル アプリに最初に [コンテンツのメインにスキップする] リンクが表示されます

  13. 必要に応じて、[スキップしてコンテンツをメイン] リンクをクリックします。

    WebView2 コントロールは、Windows フォーム フォームの WebView2 コントロールで、https://www.microsoft.comのコンテンツを表示します。

    サンプル アプリには、Microsoft Web サイトが表示されます

  14. Form1 ウィンドウを閉じます。

高解像度モニターで作業している場合は、高 DPI のサポートのためにWindows フォーム アプリを構成する必要がある場合があります。

手順 6 - コントロールを追加し、ウィンドウのサイズ変更イベントを処理する

ツールボックスからWindows フォーム フォームにさらにコントロールを追加し、次のようにウィンドウサイズ変更イベントを処理します。

  1. [ 表示>Toolbox] を選択するか、左側の [ ツールボックス ] タブをクリックします。

  2. ツールボックスで、[共通コントロール] をクリックします。

    次のように、テキスト ボックス コントロールを追加します。

  3. TextBox コントロールを Form1.cs フォーム Designer キャンバスにドラッグします。

  4. TextBox コントロールにフォーカスがあることを確認します。

  5. [ プロパティ ] パネルの [ デザイン ] セクションで、 (名前) ( おそらく textBox1) を addressBar に変更します。

    次のようにボタン コントロールを追加します。

  6. ボタン コントロールを Form1.cs フォーム Designer キャンバスにドラッグします。

  7. ボタン コントロールにフォーカスがあることを確認します。

  1. [ プロパティ ] パネルの太字の [外観 ] セクション (約 15 個のプロパティ) で 、Text プロパティ (おそらく button1 から) を Go に変更します 。

    テキスト ボックスと既存のボタンを次のように配置します。

  2. 次に示すように、フォームの左側にテキスト ボックスをボタンと垂直方向に配置します。

    WinForms デザイナー

  3. 次のようにテキスト ボックスのサイズを変更します。

    WinForms デザイナーのテキスト ボックスとボタン

  4. [ 表示>Code] をクリックして Form1.csを開きます。

    アプリ ウィンドウのサイズが変更されたときにコントロールを保持する Form_Resize を次のように定義します。

  5. 次のコードを削除します。

       public Form1()
{
   InitializeComponent();
}

  6. 次のコードを同じ場所に貼り付けます。

    public Form1()
{
   InitializeComponent();
   this.Resize += new System.EventHandler(this.Form_Resize);
}

private void Form_Resize(object sender, EventArgs e)
{
   webView.Size = this.ClientSize - new System.Drawing.Size(webView.Location);
   goButton.Left = this.ClientSize.Width - goButton.Width;
   addressBar.Width = goButton.Left - addressBar.Left;
}

    Form_Resizeコードが追加されました

  7. [ ファイル>すべて保存 (Ctrl + Shift + S) を選択してプロジェクトを保存します。

  8. F5 キーを押して、プロジェクトをビルドして実行します。

    Form1 ウィンドウが表示され、https://www.microsoft.comの Web ページ コンテンツが表示されます。

    Microsoft.com からの Web ページ コンテンツを表示する Form1 WinForm ウィンドウ

    Alt キーを押しながら Tab キーを押して Form1 ウィンドウに切り替える場合は、[スキップ] をクリックして、追加されたコンテンツ リンクメインする必要がある場合があります。

  9. マウス ホイールでウィンドウを上下にスクロールします。 入力コントロールは所定の位置に残ります。

  10. ウィンドウの隅をドラッグしてサイズを変更します。 テキスト ボックスの幅が変更されます。

  11. Form1 ウィンドウを閉じます。

手順 7 - ナビゲーション

ユーザーが WebView2 コントロールに表示される URL を、テキスト ボックスに入力されたテキストを読み取ってアドレス バーとして機能するように変更できるようにします。

  1. コード エディターでForm1.csを開くには、[表示>Code] を選択します。

  2. Form1.csで、ファイルの先頭に 1 行目として次のコードを挿入して、CoreWebView2名前空間を追加します。

    using Microsoft.Web.WebView2.Core;

  3. [デザイン] タブForm1.cs選択し、[Go!] ボタンをダブルクリックします。 goButton_Click メソッドは、Form1.cs ファイルに追加されます。

  4. 次のコードをファイルに貼り付けて、空の goButton_Click メソッドを置き換えて、メソッド本体が次のようになるようにします。

    private void goButton_Click(object sender, EventArgs e)
{
   if (webView != null && webView.CoreWebView2 != null)
   {
      webView.CoreWebView2.Navigate(addressBar.Text);
   }
}

    これで、 goButton_Click 関数は WebView2 コントロールをアドレス バーのテキスト ボックスに入力された URL に移動します。

  5. [ ファイル>すべて保存 (Ctrl + Shift + S) を選択してプロジェクトを保存します。

  6. F5 キーを押して、プロジェクトをビルドして実行します。

  7. アドレス バーに、https://www.bing.comなど、httpsで始まる URL を入力し、[Go!] ボタンをクリックします。

    bing.com

    WebView2 コントロールには、URL の Web ページ コンテンツが表示されます。

  8. アドレス バーに、www.bing.comなど、httpで始まらない文字列を入力し、[Go!] ボタンをクリックします。

    URL 以外の入力による引数例外

    URL がhttp://またはhttps://で始まらない場合、ArgumentExceptionがスローされます。

  9. [ デバッグ>デバッグの停止] を選択するか、[ 続行] をクリックします。 Form1 ウィンドウが閉じます。

手順 8 - ナビゲーション イベント

Web ページのナビゲーション中に、WebView2 コントロールによってイベントが発生します。 WebView2 コントロールをホストするアプリは、次のイベントをリッスンします。

  • NavigationStarting
  • SourceChanged
  • ContentLoading
  • HistoryChanged
  • NavigationCompleted

詳細については、「 WebView2 アプリのナビゲーション イベント」を参照してください。

ナビゲーション イベント

エラーが発生すると、次のイベントが発生し、エラー Web ページへのナビゲーションに依存する場合があります。

  • SourceChanged
  • ContentLoading
  • HistoryChanged

注:

HTTP リダイレクトが発生した場合、1 行に複数の NavigationStarting イベントがあります。

イベントの使用方法を示すために、まず HTTPS を使用しない要求を取り消す NavigationStarting のハンドラーを登録します。

  1. Form1.csで、次のコードに一致するようにForm1() コンストラクターを更新し、コンストラクターの下に次のように EnsureHttps(sender, args) 関数を追加します。

    public Form1()
{
   InitializeComponent();
   this.Resize += new System.EventHandler(this.Form_Resize);

   webView.NavigationStarting += EnsureHttps;
}

void EnsureHttps(object sender, CoreWebView2NavigationStartingEventArgs args)
{
   String uri = args.Uri;
   if (!uri.StartsWith("https://"))
   {
      args.Cancel = true;
   }
}

    コンストラクターでは、 EnsureHttps は WebView2 コントロールの NavigationStarting イベントのイベント ハンドラーとして登録されます。

  2. [ ファイル>すべて保存 (Ctrl + Shift + S) を選択してプロジェクトを保存します。

  3. F5 キーを押して、プロジェクトをビルドして実行します。

  4. アドレス バーに、https://www.bing.comなど、httpsで始まる URL を入力し、[Go!] ボタンをクリックします。

    https URL が読み込まれます。Web コンテンツは、既定の Microsoft.com から Bing.com に変更されます。

  5. アドレス バーに、http://www.microsoft.comなど、httpで始まる URL を入力し、[Go!] ボタンをクリックします。

    http URL が読み込まれません。Bing.com Web ページは引き続き表示されます。 対照的に、Microsoft Edge に http://www.microsoft.com を入力すると機能します。これは、Microsoft.com の https サイトにリダイレクトされます。

  6. アドレス バーに、https://www.microsoft.comなど、httpsで始まる URL を入力し、[Go!] ボタンをクリックします。

    https URL が読み込まれます。'http' の後に 's' を追加したので、Microsoft.com Web ページが表示されるようになりました。

手順 9 - スクリプト

ホスト アプリを使用すると、実行時に JavaScript コードを WebView2 コントロールに挿入できます。 WebView2 をタスクして、任意の JavaScript を実行したり、初期化スクリプトを追加したりできます。 挿入された JavaScript は、JavaScript が削除されるまで、すべての新しい最上位ドキュメントと子フレームに適用されます。 挿入された JavaScript は、特定のタイミングで実行されます。

  • グローバル オブジェクトの作成後に、挿入された JavaScript を実行します。

  • 挿入された JavaScript を実行してから、HTML ドキュメントに含まれる他のスクリプトを実行します。

たとえば、次のように、ユーザーが HTTPS 以外のサイトに移動したときにアラートを送信するスクリプトを追加します。

  1. EnsureHttps関数を変更して、ExecuteScriptAsyncを含む次の行を追加します。

    void EnsureHttps(object sender, CoreWebView2NavigationStartingEventArgs args)
{
   String uri = args.Uri;
   if (!uri.StartsWith("https://"))
   {
      webView.CoreWebView2.ExecuteScriptAsync($"alert('{uri} is not safe, try an https link')");
      args.Cancel = true;
   }
}

    追加された行は、 ExecuteScriptAsync メソッドを使用する Web コンテンツにスクリプトを挿入します。 追加されたスクリプトは次のとおりです。

    alert('{uri} is not safe, try an https link')

  2. [ ファイル>すべて保存 (Ctrl + Shift + S) を選択してプロジェクトを保存します。

  3. F5 キーを押して、プロジェクトをビルドして実行します。

  4. http://www.bing.com (プレフィックスではなくhttp) に移動https試してください。

    アプリにアラートが表示されます。

    代わりに https を試すという http アラート

手順 10 - ホストと Web コンテンツ間の通信

ホストと Web コンテンツは、次のように postMessage を使用して相互に通信できます。

  • WebView2 コントロールの Web コンテンツは、 window.chrome.webview.postMessage を使用してホストにメッセージを投稿できます。 ホストは、ホスト上の登録済み WebMessageReceived を使用してメッセージを処理します。

  • CoreWebView2.PostWebMessageAsStringまたはCoreWebView2.PostWebMessageAsJSONを使用して、WebView2 コントロール内の Web コンテンツにメッセージを投稿します。 これらのメッセージは、 window.chrome.webview.addEventListenerに追加されたハンドラーによってキャッチされます。

通信メカニズムは、ネイティブ機能を使用して、Web コンテンツからホストにメッセージを渡します。

プロジェクトでは、WebView2 コントロールが URL に移動すると、アドレス バーに URL が表示され、WebView2 コントロールに表示される URL のユーザーにアラートが表示されます。

  1. Form1.csで、Form1() コンストラクターを更新し、その下に次のコードに一致するInitializeAsync()関数を作成します。

    public Form1()
{
   InitializeComponent();
   this.Resize += new System.EventHandler(this.Form_Resize);
   webView.NavigationStarting += EnsureHttps;
   InitializeAsync();
}

async void InitializeAsync()
{
   await webView.EnsureCoreWebView2Async(null);
}

    CoreWebView2の初期化は非同期であるため、InitializeAsync関数は EnsureCoreWebView2Async を待機します。

    次に、 WebMessageReceivedに応答するイベント ハンドラーを登録します。 このイベント ハンドラーは、 CoreWebView2 が初期化された後に登録されます。

  2. Form1.csで、InitializeAsyncを更新し、その下に次のようにUpdateAddressBarを追加します。

    async void InitializeAsync()
{
   await webView.EnsureCoreWebView2Async(null);
   webView.CoreWebView2.WebMessageReceived += UpdateAddressBar;
}

void UpdateAddressBar(object sender, CoreWebView2WebMessageReceivedEventArgs args)
{
   String uri = args.TryGetWebMessageAsString();
   addressBar.Text = uri;
   webView.CoreWebView2.PostWebMessageAsString(uri);
}

    次に、WebView2 が Web メッセージを送信して応答するには、 CoreWebView2 が初期化された後、ホストは Web コンテンツにスクリプトを挿入します。

    • postMessageを使用してホストに URL を送信します。

    • Web ページのコンテンツを表示する前に、ホストから送信されたメッセージをアラート ボックスに表示するイベント ハンドラーを登録します。

  3. Form1.csで、次のコードに一致するようにInitializeAsyncを更新します。

    async void InitializeAsync()
{
   await webView.EnsureCoreWebView2Async(null);
   webView.CoreWebView2.WebMessageReceived += UpdateAddressBar;

   await webView.CoreWebView2.AddScriptToExecuteOnDocumentCreatedAsync("window.chrome.webview.postMessage(window.document.URL);");
   await webView.CoreWebView2.AddScriptToExecuteOnDocumentCreatedAsync("window.chrome.webview.addEventListener(\'message\', event => alert(event.data));");
}

  4. [ ファイル>すべて保存 (Ctrl + Shift + S) を選択して変更を保存します。

  5. F5 キーを押して、プロジェクトをビルドして実行します。

  6. https://www.bing.comなどの URL を入力します。

    最初に更新されたアドレス バー URL がアラート ボックスに表示されます

    最初にアラートが表示され、ホスト Web サイトから送信された結果の URL が表示されます。

  7. [OK] ボタンをクリック します 。

    WebView2 コントロールがアドレス バーに新しい URL を表示し、URL の Web ページ コンテンツが WinForms ウィンドウの WebView2 コントロールに表示されるようになりました。

    アプリケーションがアドレス バーに URL を表示する

    • アプリが起動すると、既定の URL が https://www.microsoft.comされ、結果として表示されるアドレスに、 https://www.microsoft.com/en-us/などのロケールが表示されます。

    • https://www.bing.comと入力すると、結果のアドレスはバリアント (https://www4.bing.com/?form=DCDNなど) になります。

これで、初めての WebView2 アプリが作成されました。

WebView2 アプリの配布

このチュートリアルの結果として得られたアプリを配布する場合は、WebView2 ランタイムをアプリと共に配布する必要があります。 その後、WebView2 ランタイムはユーザー マシンに自動的にインストールされます。 詳細については、「 アプリと WebView2 ランタイムを配布する」を参照してください。

関連項目