ASP.NET Core 文档示例项目教程

1. 项目目录结构及介绍

ASP.NET Core 文档示例项目的目录结构如下：

AspNetCore.Docs.Samples/
├── RazorPages/
├── common/
├── fundamentals/
├── mvc/
├── samples/
├── security/authorization/
├── signalr/hubs/
├── test/integration-tests/
├── tutorials/
├── .editorconfig
├── .gitattributes
├── .gitignore
├── CODE-OF-CONDUCT.md
├── LICENSE
├── LICENSE-CODE
├── ThirdPartyNotices

目录介绍

• RazorPages/: 包含使用 Razor Pages 的示例代码。
• common/: 包含项目中常用的通用代码和工具。
• fundamentals/: 包含 ASP.NET Core 基础概念的示例代码。
• mvc/: 包含使用 MVC 模式的示例代码。
• samples/: 包含各种示例代码，涵盖不同的功能和场景。
• security/authorization/: 包含与安全授权相关的示例代码。
• signalr/hubs/: 包含使用 SignalR 的示例代码。
• test/integration-tests/: 包含集成测试的示例代码。
• tutorials/: 包含教程相关的示例代码。
• .editorconfig: 配置文件，用于定义代码风格和格式。
• .gitattributes: Git 属性配置文件。
• .gitignore: Git 忽略文件配置。
• CODE-OF-CONDUCT.md: 贡献者行为准则。
• LICENSE: 项目许可证文件。
• LICENSE-CODE: 代码许可证文件。
• ThirdPartyNotices: 第三方通知文件。

2. 项目的启动文件介绍

在 ASP.NET Core 项目中，启动文件通常是 Program.cs 和 Startup.cs。以下是这两个文件的简要介绍：

Program.cs

Program.cs 是 ASP.NET Core 应用程序的入口点。它负责配置和启动 Web 主机。以下是一个典型的 Program.cs 文件内容：

using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Hosting;

public class Program
{
    public static void Main(string[] args)
    {
        CreateHostBuilder(args).Build().Run();
    }

    public static IHostBuilder CreateHostBuilder(string[] args) =>
        Host.CreateDefaultBuilder(args)
            .ConfigureWebHostDefaults(webBuilder =>
            {
                webBuilder.UseStartup<Startup>();
            });
}

Startup.cs

Startup.cs 文件负责配置应用程序的服务和中间件管道。以下是一个典型的 Startup.cs 文件内容：

using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;

public class Startup
{
    public Startup(IConfiguration configuration)
    {
        Configuration = configuration;
    }

    public IConfiguration Configuration { get; }

    public void ConfigureServices(IServiceCollection services)
    {
        // 配置服务
        services.AddRazorPages();
    }

    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
        if (env.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
        }
        else
        {
            app.UseExceptionHandler("/Error");
            app.UseHsts();
        }

        app.UseHttpsRedirection();
        app.UseStaticFiles();

        app.UseRouting();

        app.UseAuthorization();

        app.UseEndpoints(endpoints =>
        {
            endpoints.MapRazorPages();
        });
    }
}

3. 项目的配置文件介绍

ASP.NET Core 项目通常使用 appsettings.json 文件来存储应用程序的配置。以下是一个典型的 appsettings.json 文件内容：

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft": "Warning",
      "Microsoft.Hosting.Lifetime": "Information"
    }
  },
  "AllowedHosts": "*"
}

配置文件介绍

• Logging: 配置日志记录的级别。
  • Default: 默认日志级别。
  • Microsoft: Microsoft 命名空间下的日志级别。
  • Microsoft.Hosting.Lifetime: 主机生命周期事件的日志级别。
• AllowedHosts: 配置允许访问的主机。"*" 表示允许所有主机访问。

通过这些配置文件，开发者可以轻松地管理和调整应用程序的行为和设置。