使用 VB.NET 创建 ASP.NET Core Minimal API 教程

Visual Basic .NET（VB.NET）虽然没有 C# 或 F# 那样广受欢迎，但依然是一个强大的开发语言。在 .NET SDK 的模板中，支持 VB 的模板数量较少，但我们仍然可以使用 VB 创建 ASP.NET Core Minimal API 项目。

本教程将从一个 VB 控制台模板开始，逐步将其转换为 ASP.NET Core Minimal API 项目。

一. 先决条件

在开始之前，请确保已安装以下工具和环境：

• .NET SDK（本文基于 .NET 7，也适用于其他版本）
• 支持 VB 开发的 IDE（例如 Visual Studio 或 JetBrains Rider）

接下来，我们将创建一个 C# 最小 API 项目和一个 VB 控制台项目，并对比它们的差异。

二. 创建项目模板

在终端中运行以下命令生成项目：

dotnet new web -lang C# -o MinimalApiSharp
dotnet new console -lang VB -o MinimalApiVb

生成的项目文件结构如下：

• MinimalApiSharp/MinimalApiSharp.csproj
• MinimalApiVb/MinimalApiVb.vbproj

三. 修改项目文件

比较两个项目文件：

C# 项目 .csproj 示例：

<Project Sdk="Microsoft.NET.Sdk.Web">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net7.0</TargetFramework>
  </PropertyGroup>
</Project>

VB 控制台项目 .vbproj 示例：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net7.0</TargetFramework>
  </PropertyGroup>
</Project>

为了支持 Minimal API，需要将 VB 项目的 SDK 修改为 Microsoft.NET.Sdk.Web：

<Project Sdk="Microsoft.NET.Sdk.Web">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net7.0</TargetFramework>
  </PropertyGroup>
</Project>

保存修改后的 .vbproj 文件。

四. 转换代码文件

C# Program.cs 示例：

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.MapGet("/", () => "Hello World!");

app.Run();

VB Program.vb 转换示例：

Imports System
Imports Microsoft.AspNetCore.Builder
Imports Microsoft.Extensions.Hosting

Module Program
    Sub Main(args As String())
        Dim builder = WebApplication.CreateBuilder(args)
        Dim app = builder.Build()

        app.MapGet("/", Function() "Hello World!")

        app.Run()
    End Sub
End Module

五. 配置文件复制

为了让 VB 项目支持配置文件，可将 C# 项目中的 appsettings.json 和 appsettings.Development.json 复制到 VB 项目中，这些文件用于配置应用程序运行参数。

六. 运行和测试应用

运行以下命令启动 VB 项目：

dotnet run

成功启动后，终端会显示本地托管 URL，例如：

Now listening on: http://localhost:5000

打开浏览器访问该 URL，将显示页面内容：“Hello World!”

七. 总结

尽管 VB.NET 在 .NET SDK 模板中支持较少，但通过手动调整项目文件和代码，我们依然可以使用 VB 创建 ASP.NET Core Minimal API 项目。这展示了 .NET 平台的灵活性和兼容性。

通过本教程，您可以在 VB.NET 中轻松构建现代 Web 应用程序，并理解 Minimal API 的核心概念。

原文链接: https://swimburger.net/blog/dotnet/create-an-aspdotnet-core-minimal-api-with-vbdotnet