ASP.NET-静态文件服务配置指南

一、访问 Web 根目录 (wwwroot) 下的文件

1.​创建默认根目录：​​

• 在项目根目录下创建名为 wwwroot 的文件夹。这是 ASP.NET Core 托管静态文件（如
  HTML、CSS、JavaScript、图片）的默认根目录。

2.启用静态文件中间件：​​

• 在 Program.cs 文件的 app 构建之后（通常在 var app = builder.Build(); 之后），添加以下代码：

app.UseStaticFiles(); // 启用静态文件中间件

• 这行代码会注册中间件，使其能够处理对 wwwroot 文件夹下文件的请求。

3.访问文件

• 将文件（例如 image.jpg）放入 wwwroot 文件夹或其子文件夹中（如 wwwroot/images/image.jpg）
• 在浏览器中，使用 URL 路径 /images/image.jpg 即可访问该文件（假设应用运行在http://localhost:5000）
• 注意：URL 路径是相对于 wwwroot 的。wwwroot 本身不会出现在 URL中。

二、访问 Web 根目录之外的文件

有时需要提供 wwwroot 文件夹之外的静态文件（例如项目根目录下的自定义文件夹）。

1. ​创建自定义文件夹：​​

• 在项目根目录（与 wwwroot 同级）创建所需的文件夹，例如 MyStaticFiles。

2.​配置自定义静态文件提供程序：​​

• 在 Program.cs 中，使用 UseStaticFiles 的重载方法进行配置

app.UseStaticFiles(new StaticFileOptions
{
     FileProvider = new PhysicalFileProvider(
     	Path.Combine(builder.Environment.ContentRootPath,
    	"MyStaticFiles")),
     RequestPath = "/StaticFiles"
});

• ​FileProvider:​​
  指定物理文件提供程序。Path.Combine(builder.Environment.ContentRootPath,“MyStaticFiles”) 获取项目根目录下MyStaticFiles 文件夹的完整物理路径。
• ​RequestPath:​​ 定义访问这些文件的 URL 路径前缀。这里设置为 /StaticFiles

3.访问文件

• 将文件（例如 document.pdf）放入 MyStaticFiles 文件夹或其子文件夹中（如 MyStaticFiles/docs/document.pdf）。
• 在浏览器中，使用 URL 路径 /StaticFiles/docs/document.pdf 即可访问该文件。URL 中的 /StaticFiles 映射到物理路径 MyStaticFiles。

三、目录浏览

目录浏览功能允许用户直接查看指定目录下的文件和子目录列表。​出于安全考虑（可能暴露敏感文件结构），通常不建议在生产环境中启用此功能

1.注册目录浏览服务

• 在 Program.cs 的 builder 配置部分（通常在 var builder = WebApplication.CreateBuilder(args); 之后），添加服务注册：

builder.Services.AddDirectoryBrowser(); // 注册目录浏览服务

2.配置目录浏览中间件

• 在 app 构建之后，配置 UseDirectoryBrowser 中间件。通常将其指向之前配置的自定义静态文件文件夹

app.UseDirectoryBrowser(new DirectoryBrowserOptions
{
    FileProvider = new PhysicalFileProvider(
        Path.Combine(builder.Environment.ContentRootPath, "MyStaticFiles")),
    RequestPath = "/StaticFiles"
});

• ​FileProvider:​​ 指定要浏览的物理目录路径（与自定义静态文件配置一致）。
• RequestPath:​​ 指定触发目录浏览的 URL 路径前缀（与自定义静态文件配置一致）。

3.访问目录列表

• 在浏览器中访问配置的 RequestPath（例如 http://localhost:5000/StaticFiles）。
• 如果该路径对应的是一个物理目录（且目录中存在文件），中间件将生成并返回一个 HTML 页面，显示该目录下的文件和子目录列表（如上图所示）。