共用方式為


WinForms 範例應用程式

此範例 WebView2WindowsFormsBrowser,示範如何使用 WebView2 控制項與 WebView2 API 在 WinForms 應用程式中實作網頁瀏覽器。

  • 範例名稱: WebView2WindowsFormsBrowser。
  • Repo 目錄: WebView2WindowsFormsBrowser
  • 解答檔案: WebView2WindowsFormsBrowser.sln

WebView2WindowsForms瀏覽器應用程式視窗

  • 控制選單中有加速允許外部投放的切換選單項目。
  • 檢視選單有縮放背景色彩子選單。
  • 事件按鈕會開啟 EventMonitor 視窗。

步驟 1 - 安裝 Visual Studio

必須使用 Microsoft Visual Studio。 本範例不支援 Microsoft Visual Studio Code。

  1. 如果 Visual Studio (尚未安裝最低所需版本的) ,請在獨立視窗或分頁中查看「 安裝 Visual Studio 」中的「 設置你的開發環境」中的說明。 請依照該部分的步驟操作,然後返回此頁面繼續以下步驟。

步驟 2 - 複製或下載 WebView2Samples 倉庫

  1. 如果還沒做,請複製或下載 WebView2Samples 倉庫到本地硬碟。 在另一個視窗或分頁中,請參考「為 WebView2 建立你的開發環境下載 WebView2Samples 倉庫」。 請依照該部分的步驟操作,然後返回此頁繼續下方。

步驟 3 - 在 Visual Studio 開啟.sln

  1. 在你本機硬碟上,在 Visual Studio 的目錄中開啟這個 .sln 檔案:

    • <your-repos-directory>/WebView2Samples/SampleApps/WebView2WindowsFormsBrowser/WebView2WindowsFormsBrowser.sln

    或:

    • <your-repos-directory>/WebView2Samples-main/SampleApps/WebView2WindowsFormsBrowser/WebView2WindowsFormsBrowser.sln

步驟 4 - 如果有提示就安裝工作負載

  1. 如果有提示,請安裝任何 Visual Studio 的工作負載。 在另一個視窗或分頁中,請參考「 安裝 Visual Studio 工作負載 」的「 設置你的 WebView2 開發環境」。 請依照該部分的步驟操作,然後返回此頁繼續下方。

步驟 5 - 建置並執行專案

透過上述步驟, WebView2WindowsFormsBrowser 專案現在已在 Visual Studio 中開啟。 在 Visual Studio 頂端,設定建置目標如下:

  1. 解決方案設定 下拉選單中,選擇 除錯發布

  2. 在解決方案 平台 下拉選單中,選擇 任意 CPU

  3. 解決方案方案總管中,右鍵點擊 WebView2WindowsFormsBrowser 專案,然後選擇建置

    此時會建立專案檔案 SampleApps/WebView2WindowsFormsBrowser/WebView2WindowsFormsBrowser.vcxproj。 這可能要花幾分鐘。

    如果你收到缺少 .NET Framework 4.6.2 開發者包的錯誤訊息,請依照以下步驟操作。 否則,請跳到下方下一個主要章節。

  4. 在 Visual Studio 中,選擇 F5) (「除錯>開始除錯」。

    範例應用程式視窗會開啟:

    WebView2WindowsFormsBrowser 應用程式視窗

  5. 使用範例應用程式;請參閱 WebView2WindowsFormsBrowser 的 README 檔案

  6. 在 Visual Studio 中,選擇 除錯>停止除錯。 Visual Studio 關閉了應用程式。

步驟 6 - 安裝 .NET Framework 4.6.2 開發者包

如果你建立了 WebView2WindowsFormsBrowser 專案,卻收到缺少 .NET Framework 4.6.2 開發者包的錯誤訊息,請依照以下步驟操作。 否則,請跳到下方下一個主要章節。

  1. 請前往「下載 .NET Framework」,選擇 v4.6.2,然後點擊「下載 .NET Framework 4.6.2 開發者包」按鈕:

    下載 .NET Framework 4.6.2 開發者包

  2. 在 Microsoft Edge 中,選擇設定及更多>>,下載圖示顯示於資料夾中:

    下載 .NET Framework 開發者包

  3. 在資料夾中 Downloads ,雙擊該檔案,例如 ndp462-devpack-kb3151934-enu.exe

    Microsoft .NET Framework 開發者包授權協議對話框會出現:

    Microsoft .NET Framework 開發者包授權協議對話框

  4. 選擇 「我同意授權條款與條件 」勾選框,然後點擊 安裝 按鈕。

    會跳出 使用者帳號控制 視窗,問「你要允許這個應用程式對你的裝置做變更嗎?」

  5. 點擊 「是」 按鈕。

    會出現 Microsoft .NET Framework 開發者套件設定成功對話框:

    Microsoft .NET Framework 開發者套件「設定成功」對話框

  6. 點擊 關閉 按鈕。

Microsoft .NET Framework 4.6.2 開發人員套件現已安裝在您的電腦上。

步驟 7 - 更新或安裝 WebView2 SDK

  1. WebView2 SDK - 在專案節點上更新或安裝 WebView2 SDK, (方案總管) 的解決方案節點。 在另一個視窗或分頁中,請參考「 安裝或更新 WebView2 SDK 的設定」中的「 為 WebView2 設置你的開發環境」。 請依照該部分的步驟操作,然後返回此頁繼續下方。

    Visual Studio 中的 WebView2WindowsFormsBrowser 專案

步驟 8 - 建置並執行更新後的專案

  1. 如果你剛剛安裝了上面提到的 .NET Framework 4.6.2 開發者包,請關閉 Visual Studio,然後再從目錄中再次打開解決方案檔案:

    • <your-repos-directory>/WebView2Samples/SampleApps/WebView2WindowsFormsBrowser/WebView2WindowsFormsBrowser.sln

    或:

    • <your-repos-directory>/WebView2Samples-main/SampleApps/WebView2WindowsFormsBrowser/WebView2WindowsFormsBrowser.sln

在 Visual Studio 頂端,設定建置目標如下:

  1. 解決方案設定 下拉選單中,選擇 除錯發布

  2. 在解決方案 平台 下拉選單中,選擇 任意 CPU

  3. 解決方案方案總管中,右鍵點擊 WebView2WindowsFormsBrowser 專案,然後選擇建置

    此時會建立專案檔案 SampleApps/WebView2WindowsFormsBrowser/WebView2WindowsFormsBrowser.vcxproj

  4. 在 Visual Studio 中,選擇 F5) (「除錯>開始除錯」。

    範例應用程式視窗會開啟:

    WebView2WindowsFormsBrowser 應用程式視窗

    • 控制選單中有加速允許外部投放的切換選單項目。
    • 檢視選單有縮放背景色彩子選單。
    • 事件按鈕會開啟 EventMonitor 視窗。
  5. 在 Visual Studio 中,選擇 除錯>停止除錯。 Visual Studio 關閉了應用程式。

步驟 9 - 檢查程式碼

  1. 在 Visual Studio 程式碼編輯器中檢查程式碼:

    Visual Studio 中的 WebView2WindowsFormsBrowser 專案

另請參閱