Web Form 打包成 EXE 文件教程
在某些场合，您可能需要将 Web Form（也被称为ASP.NET Web 窗体应用程序）打包成一个独立的可执行文件（.exe）。 这通常用于进行快速演示、密闭的内部工具和本地窗体应用程序。 基于这个需求，本文将详细介绍如何将 Web Form 打包成 EXE 文件，同时包括原理和实操步骤。
原理：
把 Web Form 打包成 EXE 文件的关键在于引入一个轻量级的 Web 服务器，将其与 Web 应用程序捆绑在一起形成一个独立的可执行文件。这个轻量级的 Web 服务器将在用户机器上运行，提供类似于 IIS 或 Apache 的功能，用于托管您的 Web 应用程序。这样，用户只需双击 EXE 文件，即可启动 Web 服务器并访问您的 Web 应用程序。
操作步骤：
一种可行的方法是使用 Chromium 为基础的浏览器引擎和一个自包含的 HTTP 服务器将 Web Form 应用程序与 .NET Core 或 .NET 5+ 结合。下面是将 Web Form 应用程序打包成EXE文件的详细步骤：
1. 首先，确保您的电脑安装了.NET 5 SDK。如果没有，请前往官方网站 (https://dotnet.microsoft.com/download/dotnet/5.0) 下载并安装。
2. 使用 Visual Studio 打开您的 Web Form 项目，右击项目名称，选择 "添加" > "新建项目"，选择 ".NET Core 类库"，并命名为 "WebFormPackager"。
3. 接下来，我们需要添加几个 NuGet 包。右键点击 WebFormPackager 项目，选择 "管理 NuGet 程序包"，搜索并安装以下包：
- Microsoft.AspNetCore.Components.WebView.WindowsForms
- Webview2 Runtime
- Xilium.CefGlue
4. 在新建的 WebFormPackager 项目中添加一个 WebFormBrowser 类，用于加载 WebView 控件：
```
using System.Windows.Forms;
using Microsoft.AspNetCore.Components.WebView.WindowsForms;
public class WebFormBrowser : Form
{
private readonly WebView2Control _webView;
public WebFormBrowser(string url)
{
_webView = new WebView2Control
{
Dock = DockStyle.Fill,
Source = new System.Uri(url),
};
Controls.Add(_webView);
}
}
```
5. 编辑 WebFormPackager 项目的 "Program.cs" 文件, 在 Main 方法中添加以下代码，同时将 "WebFormBrowser" 类设置为起始类：
```
using System;
using System.Windows.Forms;
class Program
{
static void Main(string[] args)
{
Application.EnableVisualStyles();
Application.SetCompatibleTextRenderingDefault(false);
string url = "http://127.0.0.1:5000"; // 修改为您的 Web 应用程序的 URL
Application.Run(new WebFormBrowser(url));
}
}
```
6. 在 WebFormPackager 项目中添加一个新的类 "HttpServer.cs"，用于启动一个简单的 HTTP 服务器。以下是一个使用 Microsoft.AspNetCore.Hosting 和 Microsoft.AspNetCore.Server.Kestrel 的简单 HTTP 服务器示例：
```
using System;
using System.IO;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Hosting;
public class HttpServer
{
private readonly Action _onStopped;
public HttpServer(string contentRootPath, Action onStopped)
{
_onStopped = onStopped ?? throw new ArgumentNullException(nameof(onStopped));
CreateHostBuilder(contentRootPath).Build().RunAsync();
}
public static IHostBuilder CreateHostBuilder(string contentRootPath) =>
Host.CreateDefaultBuilder()
.ConfigureWebHostDefaults(webBuilder =>
{
webBuilder.UseKestrel()
.UseContentRoot(contentRootPath)
.UseWebRoot(contentRootPath)
.UseUrls("http://*:5000") // 使用 * 可以绑定到所有可用的地址
.UseStartup();
});
private class Startup
{
public void ConfigureServices(IServiceCollection services)
{
}
public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
app.UseStaticFiles();
app.Use(async (context, next) =>
{
await next.Invoke();
if (!Path.HasExtension(context.Request.Path.Value) && context.Response.StatusCode == 404)
{
context.Request.Path = "/index.html";
await next.Invoke();
}
});
}
}
}
```
现在，在 Program.cs 中的 Main 方法中，启动我们刚刚创建的 HttpServer，用于提供 Web Form 应用程序：
```
string contentRootPath = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "..\\..\\..\\..\\WebFormApp\\wwwroot");
new HttpServer(contentRootPath, () => Application.ExitThread());
```
7. 更改解决方案的启动项目为 WebFormPackager，然后运行项目。您的 Web Form 应用程序将在一个独立的 Windows Forms 应用程序中启动。
8. 最后，您可以使用各种方式将您的项目打包成单个 EXE 文件。其中之一是使用 ILMerge 工具将所有依赖项合并到一个 EXE 中。根据需要进行调整、优化和测试后，您可以将此组合打包成一个独立的 EXE 文件。
通过以上步骤，您可以将 Web Form 应用程序成功打包为 EXE 文件。现在您可以在没有安装 IIS 或其他 Web 服务器的计算机上运行该 EXE 文件，轻松部署和演示您的 Web 应用。
