在现代软件开发中，WebAPI作为一种轻量级、跨平台的接口，广泛应用于网页、手机和电脑等不同终端的数据交互。借助Visual Studio 2019（VS2019）和Entity Framework（EF），我们可以轻松构建一个后端服务，从SQL Server数据库中获取数据，并支持多端访问。本教程将一步步指导你完成整个过程。
第一步：环境准备和项目创建
- 安装必要软件：确保已安装VS2019、.NET Core SDK（建议3.1或更高版本）以及SQL Server（本地或远程）。VS2019社区版是免费的，适合学习和开发。
- 创建新项目：打开VS2019，选择“创建新项目”，然后选择“ASP.NET Core Web应用程序”模板。在配置窗口中，输入项目名称（例如“CrossPlatformWebAPI”），选择.NET Core版本，并勾选“API”作为项目类型。这将生成一个基础的WebAPI项目结构。
第二步：配置数据库和Entity Framework
- 安装EF Core包：在项目中，通过NuGet包管理器安装必要的EF Core包。打开“工具”>“NuGet包管理器”>“管理解决方案的NuGet包”，搜索并安装以下包：
- Microsoft.EntityFrameworkCore
- Microsoft.EntityFrameworkCore.SqlServer（用于连接SQL Server）
- Microsoft.EntityFrameworkCore.Tools（用于数据库迁移）
- 创建数据模型和上下文：在项目中添加一个“Models”文件夹，创建数据模型类（例如
Product.cs），定义属性如Id、Name等。然后，创建一个继承自DbContext的类（例如AppDbContext.cs），并在其中配置数据库连接。在Startup.cs文件的ConfigureServices方法中，添加服务配置：services.AddDbContext<AppDbContext>(options => options.UseSqlServer(Configuration.GetConnectionString("DefaultConnection")));。 - 配置连接字符串：在
appsettings.json文件中，添加SQL Server连接字符串，例如："ConnectionStrings": { "DefaultConnection": "Server=localhost;Database=MyDatabase;Trusted_Connection=true;" }。确保数据库存在，或通过EF迁移创建它。 - 运行迁移：打开包管理器控制台，执行命令
Add-Migration InitialCreate和Update-Database，以在SQL Server中生成表。
第三步：实现WebAPI控制器
1. 创建API控制器：在“Controllers”文件夹中，右键添加新项，选择“API控制器 - 空”或使用脚手架生成（右键>添加>控制器，选择“使用Entity Framework的API控制器”）。例如，创建一个ProductsController，继承自ControllerBase，并注入AppDbContext。
2. 添加CRUD方法：在控制器中，实现GET、POST等方法。例如，添加一个GET方法从数据库获取所有产品：
`csharp
[HttpGet]
public async Task
{
return await _context.Products.ToListAsync();
}
`
确保使用异步方法提高性能。
第四步：测试和运行API
- 运行项目：按F5或点击“运行”按钮启动API。VS2019将启动IIS Express，并在浏览器中显示一个默认页面（通常是Swagger UI，如果安装了Swagger包），列出所有API端点。
- 测试API：使用工具如Postman或浏览器访问API端点（例如
https://localhost:5001/api/products），验证是否返回JSON格式的数据。
第五步：连接网页、手机和电脑端
1. 网页端连接：在前端网页（如HTML/JavaScript）中使用fetch或Axios库调用API。例如：
`javascript
fetch('https://localhost:5001/api/products')
.then(response => response.json())
.then(data => console.log(data));
`
注意处理跨域问题：在Startup.cs的ConfigureServices中添加services.AddCors()，并在Configure方法中使用app.UseCors(builder => builder.AllowAnyOrigin().AllowAnyMethod().AllowAnyHeader())（生产环境应限制来源）。
- 手机和电脑端连接：对于移动应用（如使用React Native或Flutter）或桌面应用（如WPF或Windows Forms），可以使用HTTP客户端（如HttpClient in .NET）调用相同的API端点。确保应用能够处理HTTPS和网络请求。
第六步：部署和优化
- 部署API：将API发布到IIS、Azure或Docker容器中，确保SQL Server可访问。
- 安全考虑：添加身份验证（如JWT）、授权和输入验证，以保护数据。
- 性能优化：使用EF Core的异步操作、分页查询和缓存机制提升响应速度。
通过以上步骤，你可以快速构建一个支持网页、手机和电脑三端连接的WebAPI，实现从后端通过EF获取SQL Server数据的功能。这个过程不仅适用于计算机网络应用软件开发，还为扩展更多功能（如实时通信或微服务）奠定了基础。如果有问题，参考微软官方文档或社区论坛获取帮助。
