作者：Daniel Roth、Rick Anderson 和 Shaun Luttin

ASP.NET Core 是一个跨平台的高性能开源框架，用于生成基于云且连接 Internet 的新式应用程序。 使用 ASP.NET Core，您可以：

• 创建 Web 应用和服务、IoT 应用和移动后端。
• 在 Windows、macOS 和 Linux 上使用喜爱的开发工具。
• 部署到云或本地。
• 在 .NET Core 或 .NET Framework 上运行。

为何选择 ASP.NET Core？

数百万开发人员使用过（并将继续使用）ASP.NET 4.x 创建 Web 应用。 ASP.NET Core 是对 ASP.NET 4.x 的重新设计，通过体系结构上的更改，产生了更精简、更模块化的框架。

ASP.NET Core 具有如下优点：

• 生成 Web UI 和 Web API 的统一场景。
• 针对可测试性进行构建。
• Razor Pages 可以使基于页面的编码方式更简单高效。
• Blazor 允许你在浏览器中使用 C# 和 JavaScript。 共享全部使用 .NET 编写的服务器端和客户端应用逻辑。
• 能够在 Windows、macOS 和 Linux 上进行开发和运行。
• 开放源代码和以社区为中心。
• 集成新式客户端框架和开发工作流。
• 支持使用 gRPC 托管远程过程调用 (RPC)。
• 基于环境的云就绪配置系统。
• 内置依赖项注入。
• 轻型的高性能模块化 HTTP 请求管道。
• 能够托管于以下各项：
  • Kestrel
  • IIS
  • HTTP.sys
  • Nginx
  • Apache
  • Docker
• 并行版本控制。
• 简化新式 Web 开发的工具。

使用 ASP.NET Core MVC 生成 Web API 和 Web UI

ASP.NET Core MVC 提供生成 Web API 和 Web 应用所需的功能：

• Model-View-Controller (MVC) 模式 使 Web API 和 Web 应用可测试。
• Razor Pages 是基于页面的编程模型，它让 Web UI 的生成更加简单高效。
• Razor 标记提供了适用于 Razor 页面和 MVC 视图的高效语法。
• 标记帮助程序使服务器端代码可以在 Razor 文件中参与创建和呈现 HTML 元素。
• 内置的多数据格式和内容协商支持使 Web API 可访问多种客户端，包括浏览器和移动设备。
• 模型绑定自动将 HTTP 请求中的数据映射到操作方法参数。
• 模型验证自动执行客户端和服务器端验证。

客户端开发

ASP.NET Core 与常用客户端框架和库（包括 [!OP.NO-LOC(Blazor)]、Angular、React 和 Bootstrap）无缝集成。 有关详细信息，请参阅 ASP.NET Core Blazor 简介 和“客户端开发”下的相关主题。

面向 .NET Framework 的 ASP.NET Core

ASP.NET Core 2.x 可以面向 .NET Core 或 .NET Framework。 面向 .NET Framework 的 ASP.NET Core 应用无法跨平台，它们仅在 Windows 上运行。 通常，ASP.NET Core 2.x 由 .NET Standard 库组成。 使用 .NET Standard 2.0 编写的库在实现 .NET Standard 2.0 的任何 .NET 平台上运行。

ASP.NET Core 2.x 在实现 .NET Standard 2.0 的 .NET Framework 版本上受支持：

• 强烈建议使用最新版本的 .NET Framework。
• .NET Framework 4.6.1 及更高版本。

ASP.NET Core 3.0 以及更高版本只能在 .NET Core 中运行。 有关此更改的详细信息，请参阅 A first look at changes coming in ASP.NET Core 3.0（抢先了解 ASP.NET Core 3.0 即将推出的更改）。

面向 .NET Core 有以下几个优势，并且这些优势会随着每次发布增加。 与 .NET Framework 相比，.NET Core 的部分优势包括：

• 跨平台。 在 macOS、Linux 和 Windows 上运行。
• 性能更强
• 并行版本控制
• 新 API
• 开源

我们正努力缩小 .NET Framework 与 .NET Core 的 API 差距。 Windows 兼容性包使数千个仅可在Windows运行的API 可在 .NET Core 中使用。 这些 API 在 .NET Core 1.x 中不可用。

推荐的学习路径

建议通过以下一系列教程和文章来了解如何开发 ASP.NET Core 应用：

1. 按照你要开发或维护的应用类型的教程操作：

   应用类型	方案	教程
   Web 应用	用于新的开发	Razor 页面入门
   Web 应用	用于维护 MVC 应用	MVC 入门
   Web API		创建 Web API*
   实时应用		开始使用 [!OP.NO-LOC(SignalR)]
   [!OP.NO-LOC(Blazor)] 应用		开始使用 [!OP.NO-LOC(Blazor)]
   远程过程调用应用		开始使用 gRPC 服务

2. 按照介绍如何进行基本数据访问的教程操作：

   方案	教程
   用于新的开发	结合使用 Razor Pages 和 Entity Framework Core
   用于维护 MVC 应用	结合使用 MVC 和 Entity Framework Core

3. 阅读适用于所有应用类型的 ASP.NET Core 功能的概述：

   • 基础知识

4. 浏览目录以了解其他感兴趣的主题。

* 新增了在浏览器中完全遵循的 Web API 教程，无需安装本地 IDE。 代码在 Azure Cloud Shell 中运行，并且 curl 用于测试。

从 .NET Framework 迁移

有关将 ASP.NET 应用迁移到 ASP.NET Core 的参考指南，请参阅 从 ASP.NET 迁移到 ASP.NET Core。

如何下载示例

很多文章和教程中都包含有示例代码链接。

1. 下载 ASP.NET 存储库 zip 文件。
2. 解压缩 Docs-master.zip 文件。
3. 使用示例链接中的 URL 帮助你导航到示例目录。

示例代码中的预处理器指令

为了演示多个方案，示例应用使用 #define 和 #if-#else/#elif-#endif 预处理器指令选择性地编译和运行示例代码中不同的片段。 对于那些利用此方法的示例，请将 C# 文件顶部的 #define 指令设置为定义与你想要运行的方案相关联的符号。 一些示例要求在多个文件的顶部定义符号才能运行方案。

例如，以下 #define 符号列表指示四个方案可用（每个符号一个方案）。 当前示例配置运行 TemplateCode 方案：

#define TemplateCode // or LogFromMain or ExpandDefault or FilterInCode

若要更改示例以运行 ExpandDefault 方案，请定义 ExpandDefault 符号并保留剩余的符号处于被注释掉的状态：

#define ExpandDefault // TemplateCode or LogFromMain or FilterInCode

若要详细了解如何使用 C# 预处理器指令选择性地编译代码段，请参阅 #define（C# 参考）和 #if（C# 参考）。

示例代码中的区域

一些示例应用包含由 #region 和 #endregion C# 指令包围的代码片段。 文档生成系统会将这些区域注入到所呈现的文档主题中。

区域名称通常包含“代码段”一词。 下面的示例显示了一个名为 snippet_WebHostDefaults 的区域：

#region snippet_WebHostDefaults
Host.CreateDefaultBuilder(args)
    .ConfigureWebHostDefaults(webBuilder =>
    {
        webBuilder.UseStartup<Startup>();
    });
#endregion

主题的 Markdown 文件在以下行中引用了前面的 C# 代码片段：

[!code-csharp[](sample/SampleApp/Program.cs?name=snippet_WebHostDefaults)]

可放心忽略（或删除）代码两侧的 #region 和 #endregion 指令。 如果计划运行主题中所述的示例方案，请不要更改这些指令中的代码。 试用其他方案时，可随时更改代码。

有关详细信息，请参阅参与 ASP.NET 文档：代码片段。

后续步骤

有关更多信息，请参见以下资源：

• ASP.NET Core 入门
• 使用 Visual Studio 将 ASP.NET Core 应用发布到 Azure
• ASP.NET Core 基础知识
• 每周 ASP.NET Community Standup 介绍了团队的工作进度和计划。 它以新博客和第三方软件为重点。