在 ASP.NET Core 應用程式中提供靜態檔案

若要在 ASP.NET Core 中啟用靜態檔案處理，請呼叫 MapStaticAssets。

預設情況下，將靜態檔案儲存在專案的 網頁根 目錄中。 預設目錄是 {CONTENT ROOT}/wwwroot，其中 {CONTENT ROOT} 預留位置是應用程式的內容 根目錄。 只有資料夾裡 wwwroot 的檔案是可位址的，所以你不用擔心其他程式碼。

只有具有特定副檔名對應至支援媒體類型的檔案才會被視為靜態網頁資產。

靜態 Web 資產會在建置時被發現，並透過內容指紋進行最佳化，以防止重複利用舊檔案。 資產也會 壓縮 ，以減少資產交付時間。

在執行階段，探索到的靜態 Web 資產會公開為套用 HTTP 標頭的端點，例如 快取標頭 和內容類型標頭。 資源只會提供一次，直到檔案變更或瀏覽器清除其快取為止。 ETag、Last-Modified 和 Content-Type 標頭已設定。 更新應用程式後，瀏覽器無法使用過時的資產。

靜態資產的傳遞是以 端點路由為基礎，因此它可與其他端點感知功能搭配使用，例如授權。 其設計目的是要處理所有 UI 架構，包括 Blazor、Razor Pages 和 MVC。

映射靜態資產提供下列優點：

• 應用程式中所有資產的建置時間壓縮，包括 JavaScript （JS）和樣式表單，但不包括已壓縮的影像和字型資產。 Gzip （Content-Encoding: gz） 壓縮會在開發期間使用。 Gzip 和 Brotli （Content-Encoding: br） 壓縮在發佈期間都會使用。
• 使用每個檔案內容之 SHA-256 哈希的 Base64編碼字串，在建置時間 所有資產的指紋。 這可防止重複使用舊版的檔案，即使已快取舊檔案也一樣。 帶有指紋的資產會使用 immutable 指令來快取，這樣一來，直到資產變更為止，瀏覽器都不會再次請求該資產。 對於不支援 immutable 指示詞的瀏覽器，會新增 max-age 指示詞。
  • 即使一個資產沒有經過指紋處理，也會為每個靜態資產生成基於內容的 ETags，並使用檔案的指紋哈希作為 ETag 值。 這可確保瀏覽器只有在內容變更時才會下載檔案（或檔案第一次下載）。
  • 在內部，架構會將實體資產對應至其指紋，讓應用程式能夠：
    • 尋找自動產生的資產，例如 Razor 元件範圍的 CSS（用於 Blazor 的 CSS 隔離功能），以及由 JS描述的 JS 資產。
    • 在頁面 <head> 內容中產生連結標籤，以預先載入資產。

Map Static Assets 不提供縮小化或其他檔案轉換功能。 縮小化通常是由自訂程式碼或 第三方工具來處理。

若要在 ASP.NET Core 中啟用靜態檔案處理，請呼叫 UseStaticFiles。

預設情況下，將靜態檔案儲存在專案的 網頁根 目錄中。 預設目錄是 {CONTENT ROOT}/wwwroot，其中 {CONTENT ROOT} 預留位置是應用程式的內容 根目錄。 只有資料夾裡 wwwroot 的檔案是可位址的，所以你不用擔心其他程式碼。

在執行階段，當要求靜態 Web 資產時，靜態檔案中介軟體會傳回這些資產，並套用資產修改相關標頭和內容類型標頭。 ETag、Last-Modified 和 Content-Type 標頭已設定。

靜態檔案中介軟體可提供靜態檔案，並且當應用程式在其要求處理管線中呼叫 UseStaticFiles 時會使用它。 檔案會從 或 IWebHostEnvironment.WebRootPath中WebRootFileProvider指定的路徑提供，該路徑預設為 Web 根資料夾，通常是 wwwroot。

CreateBuilder 方法可將內容根目錄設定為目前的目錄：

var builder = WebApplication.CreateBuilder(args);

CreateDefaultBuilder 方法可將內容根目錄設定為目前的目錄：

Host.CreateDefaultBuilder(args)

在請求處理管線中，於呼叫 UseHttpsRedirection 之後，請呼叫 MapStaticAssets，以啟用從應用程式的 Web 根目錄 提供靜態檔案：

app.MapStaticAssets();

在請求處理管線中，於呼叫 UseHttpsRedirection 之後，請呼叫 UseStaticFiles，以啟用從應用程式的 Web 根目錄 提供靜態檔案：

app.UseStaticFiles();

中斷中間件管道

若要避免在比對靜態資產之後執行整個中介軟體管線，這是 UseStaticFiles 的行為，請在 ShortCircuit 上呼叫 MapStaticAssets。 立即呼叫 ShortCircuit 會執行端點並回傳回應，防止其他中間件執行靜態資產請求。

app.MapStaticAssets().ShortCircuit();

在開發期間管理靜態檔案快取

在 Development 環境中執行時，例如在 Visual Studio 即時重載 開發測試期間，框架會覆寫快取頭，以防止瀏覽器快取靜態檔案。 此行為有助於確保檔案變更時仍使用最新版本，避免內容陳舊的問題。 在生產環境中，框架會設定正確的快取標頭，讓瀏覽器能如預期快取靜態資產。

要停用此行為，請在EnableStaticAssetsDevelopmentCaching環境中的應用程式設定檔true（）中設定Development為 appsettings.Development.json （）。

使用IWebHostEnvironment.WebRootPath在 Web 根目錄之外提供檔案

當你設定 IWebHostEnvironment.WebRootPath 為非 wwwroot的資料夾時，應用程式會呈現以下預設行為：

• 在Development環境中，若同名資產同時存在於wwwroot與分配給wwwroot的不同資料夾，靜態資產則會從WebRootPath中提供。
• 在Development之外的任何環境中，重複的靜態資產會從 WebRootPath 資料夾提供。

假設從空白 Web 範本建立的 Web 應用程式：

• 在 Index.html 和 wwwroot 中包含 wwwroot-custom 檔案。
• Program檔案已更新以進行WebRootPath = "wwwroot-custom"配置設定。

var builder = WebApplication.CreateBuilder(new WebApplicationOptions
{
    Args = args,
    WebRootPath = "wwwroot-custom"
});

依預設，對 / 的請求：

• 在Development環境中，wwwroot/Index.html會被返回。
• 在任何非Development環境中，會返回wwwroot-custom/Index.html。

若要確保來自 wwwroot-custom 的資產一律傳回，請使用下列 一種 方法：

• 刪除重複命名的資產於 wwwroot。

• 將 ASPNETCORE_ENVIRONMENT 中的 Properties/launchSettings.json 設定為 Development 以外的任何值。

• 在應用程式的專案檔中將 <StaticWebAssetsEnabled> 設定為 false 以停用靜態 Web 資產。 警告： 停用靜態 Web 資產會停用Razor類別庫。

• 將下列 XML 新增至項目檔：

  <ItemGroup>
    <Content Remove="wwwroot\**" />
  </ItemGroup>
  

下列程式碼會將 WebRootPath 更新為非 Development 值（Staging），保證重複的內容是從 wwwroot-custom 而非 wwwroot 傳回：

var builder = WebApplication.CreateBuilder(new WebApplicationOptions
{
    Args = args,
    EnvironmentName = Environments.Staging,
    WebRootPath = "wwwroot-custom"
});

靜態檔案中介軟體

靜態檔案中介軟體可在特定的靜態檔案情境中提供靜態檔案服務，通常是作為 Map Static Assets 端點路由慣例（MapStaticAssets）之外的補充。

當您在應用程式的要求處理管線中呼叫 UseStaticFiles 時，請將靜態檔案中介軟體納入要求處理，通常是在新增 Map Static Assets 端點慣例之後 (MapStaticAssets)。

在針對 .NET 9 或更新版本的應用程式中使用 Map Static Assets 端點慣例。 在以 .NET 9 之前版本為目標的應用程式中使用靜態檔案中介軟體。

靜態檔案中介軟體提供靜態檔案，但無法提供像 Map Static Assets 端點慣例那樣的優化。 當你僅依賴靜態檔案中介軟體時，將無法使用 Map Static Assets 端點慣例的建置時壓縮和指紋識別功能。

端點慣例是為了服務應用程式在執行時已知的資產而優化的。 若應用程式提供來自其他位置的資產，如磁碟或嵌入式資源，則使用靜態檔案中介軟體。

本文涵蓋的以下功能在靜態檔案中介軟體中支援，但不支援 Map Static Assets 端點慣例：

• 在網頁根目錄之外提供檔案
• 設定 HTTP 回應標頭
• 從磁碟或內嵌資源或其他位置 提供檔案
• 目錄瀏覽
• 提供預設文件 （帶有 MapStaticAssets，需要呼叫至 UseStaticFiles）
• 結合靜態檔案、預設文件和目錄瀏覽
• 將副檔名對應至 MIME 類型
• 提供非標準內容類型

本節中的指引適用於 Razor Pages 和 MVC 應用程式。 如需適用於 Blazor Web App 的指導，請參閱 ASP.NET Core Blazor 靜態檔案。

請考慮下列顯示公司標誌的標記：

<img src="~/logo.png" asp-append-version="true" alt="Company logo">

開發人員打算使用 影像標籤協助程式 來附加版本，並從自訂位置（名為 ExtraStaticFiles的資料夾）提供檔案。

下列範例會呼叫 MapStaticAssets 以提供來自 wwwroot 的檔案，以及呼叫 UseStaticFiles 以提供來自 ExtraStaticFiles 的檔案。

在請求處理流程中，在對現有呼叫MapStaticAssets（.NET 9或更新版本）或UseStaticFiles（.NET 8或更早版本）之後：

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

下列範例會呼叫 UseStaticFiles 兩次，以同時提供來自 wwwroot 和 ExtraStaticFiles的檔案。

在請求處理管線中，於現有對 UseStaticFiles 的呼叫之後：

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

使用上述程式碼，會顯示檔案 ExtraStaticFiles/logo.png 。 不過，不會套用 影像標籤協助程式（AppendVersion），因為標籤協助程式相依於 WebRootFileProvider，而該協助程式尚未更新以包含 ExtraStaticFiles 資料夾。

下列程式碼會使用WebRootFileProvider將ExtraStaticFiles更新以包含CompositeFileProvider資料夾。 這可讓影像標籤輔助器將版本套用至位於 ExtraStaticFiles 資料夾中的影像。

下列 API 的命名空間：

using Microsoft.Extensions.FileProviders;

在現有呼叫 MapStaticAssets （.NET 9 或更新版本） 或 UseStaticFiles （.NET 8 或更早版本） 之前的要求處理管線中：

var webRootProvider = new PhysicalFileProvider(builder.Environment.WebRootPath);
var newPathProvider = new PhysicalFileProvider(
    Path.Combine(builder.Environment.ContentRootPath, "ExtraStaticFiles"));

var compositeProvider = new CompositeFileProvider(webRootProvider, newPathProvider);

app.Environment.WebRootFileProvider = compositeProvider;

靜態資產清單

MapStaticAssets 根據 靜態資產資訊清單 提供資產，而不是在執行階段掃描 網站根目錄。 清單會在建置與發佈時產生，記錄為應用程式發現的靜態網頁資產，以及內容指紋、 Content-Type 標頭、快取標頭和預先計算的壓縮表示（Gzip 和 Brotli）等元資料。 執行時，讀取 MapStaticAssets 清單，為每個資產註冊端點，並提供最佳化回應。

建置過程會在建置輸出目錄中產生清單。 其檔案名稱基於專案的組合名稱（例如 {ASSEMBLY NAME}.staticwebassets.endpoints.json， {ASSEMBLY NAME} 佔位符是應用程式的 MSBuild AssemblyName 值）。 若想提供來自不同地點的清單，請參閱 「提供自訂靜態檔案清單 」章節。

因為它 MapStaticAssets 只服務清單中列出的資產，不會服務不屬於清單的檔案。 在以下情況下，檔案不屬於資訊清單的一部分：

• 位於建置階段 Web 根目錄之外，例如從磁碟提供的檔案、嵌入式資源，或在執行階段設定的自訂 WebRootPath。
• 以 StaticWebAssetEndpointExclusionPattern MSBuild 屬性排除在清單之外（見 「資產大集合 」章節）。

若要提供不在清單中的檔案，請呼叫 UseStaticFiles，執行時會直接從網頁根提供檔案。 這也是為什麼以 提供 MapStaticAssets 需要呼叫 UseStaticFiles 的原因。

將建置產生的檔案整合到靜態網頁資產中

建置工具，如 TypeScript 編譯器和 JavaScript 打包器，通常會在建置過程中產生檔案。 若要以 MapStaticAssets 提供的指紋辨識、壓縮和快取機制來提供這些產生的檔案，則必須在建置期間將這些檔案辨識為靜態 Web 資產。 產生的檔案通常會被放在網頁根wwwroot目錄外（），並排除在原始碼控制之外，因此預設不會被發現為靜態網頁資產。 只有在建置期間解析靜態 Web 資產時被判定為位於 wwwroot 之下的檔案，才會加入 靜態資產資訊清單，並由 MapStaticAssets 提供。 連結到 wwwroot （例如，包含 <Content> item 和 Link）的檔案也會被包含在內，即使原始檔案存放在 wwwroot之外。

若要將建置產生的檔案納入靜態網頁資產，請採用以下任一方法。

將產生的檔案連結到網頁根目錄

新增一個<Content>項目，並使用 Link 將每個產生的檔案放置於 wwwroot。 連結到 wwwroot 的檔案會由靜態 Web 資產管線探索到，並由 MapStaticAssets 提供，且套用指紋識別、壓縮和快取，即使原始檔案儲存在 wwwroot 之外也是如此。

以下範例中，建置步驟會在 main.js 資料夾 generated 中產生，該 <Content> 項目將檔案連結至 wwwroot：

<ItemGroup>
  <Content Include="generated\main.js" Link="wwwroot\main.js"
    CopyToOutputDirectory="PreserveNewest" />
</ItemGroup>

當建置過程解析靜態網頁資產時，產生的檔案必須存在。

使用 JavaScript 專案來處理複雜的建置流程

對於複雜的 JavaScript 或 TypeScript 用戶端建置，請使用一個獨立的 JavaScript 專案，該專案透過 JavaScript 專案系統Microsoft.VisualStudio.JavaScript.Sdk（MSBuild SDK 及專案檔案）.esproj來建立客戶端資產。 參考 ASP.NET Core 應用程式中的 JavaScript 專案，使其輸出以靜態網頁資產的形式被使用。 舉例來說，請參考Microsoft.FluentUI.AspNetCore.Components.Assets.esproj專案檔案（microsoft/fluentui-blazorGitHub 倉庫）。

當應用程式採用 後援授權原則時，若授權中介軟體所處理的要求無法從授權中繼資料產生任何原則，則會要求授權。 此要求包括對映射為端點的靜態資產請求。 若要允許匿名存取靜態資產，請套用 AllowAnonymousAttribute 到端點建構器：

app.MapStaticAssets().Add(endpointBuilder => 
    endpointBuilder.Metadata.Add(new AllowAnonymousAttribute()));

當應用程式採用 備用授權原則 時，如果授權中介軟體處理要求時未根據授權中繼資料產生任何原則，則必須進行授權。 ASP.NET Core 範本允許在呼叫UseStaticFiles之前呼叫UseAuthorization靜態檔案，以匿名存取靜態檔案。 大部分的應用程式都遵循此模式。 當靜態檔案中介軟體先於授權中介軟體被呼叫時：

• 靜態檔案上不會執行授權檢查。
• 靜態檔案中介軟體所提供的靜態檔案，例如網頁根目錄（通常為 wwwroot），是公開可存取的。

下列 API 的命名空間：

using Microsoft.AspNetCore.Authorization;
using Microsoft.Extensions.FileProviders;

服務報名：

builder.Services.AddAuthorization(options =>
{
    options.FallbackPolicy = new AuthorizationPolicyBuilder()
        .RequireAuthenticatedUser()
        .Build();
});

呼叫 UseAuthorization 後的請求處理管線中：

app.UseStaticFiles(new StaticFileOptions
{
    FileProvider = new PhysicalFileProvider(
        Path.Combine(builder.Environment.ContentRootPath, "SecureStaticFiles")),
    RequestPath = "/static-files"
});

下列 API 的命名空間：

using Microsoft.AspNetCore.Authorization;
using Microsoft.Extensions.FileProviders;

在 Startup.ConfigureServices 中：

services.AddAuthorization(options =>
{
    options.FallbackPolicy = new AuthorizationPolicyBuilder()
        .RequireAuthenticatedUser()
        .Build();
});

在 Startup.Configure 呼叫 UseAuthorization 後，

app.UseStaticFiles(new StaticFileOptions
{
    FileProvider = new PhysicalFileProvider(
        Path.Combine(env.ContentRootPath, "SecureStaticFiles")),
    RequestPath = "/static-files"
});

在 Program 檔案中：

builder.Services.AddAuthorization(options =>
{
    options.AddPolicy("AuthenticatedUsers", b => b.RequireAuthenticatedUser());
});

...

app.MapGet("/files/{fileName}", IResult (string fileName) => 
{
    var filePath = GetOrCreateFilePath(fileName);

    if (File.Exists(filePath))
    {
        return TypedResults.PhysicalFile(filePath, fileName);
    }

    return TypedResults.NotFound("No file found with the supplied file name");
})
.WithName("GetFileByName")
.RequireAuthorization("AuthenticatedUsers");

以下路由端點範例為管理員角色admin（）上傳已認證使用者的檔案。

在 Program 檔案中：

builder.Services.AddAuthorization(options =>
{
    options.AddPolicy("AdminsOnly", b => b.RequireRole("admin"));
});

...

// IFormFile uses memory buffer for uploading. For handling large 
// files, use streaming instead. See the *File uploads* article
// in the ASP.NET Core documentation:
// https://learn.microsoft.com/aspnet/core/mvc/models/file-uploads
app.MapPost("/files", async (IFormFile file, LinkGenerator linker, 
    HttpContext context) =>
{
    // Don't rely on the value in 'file.FileName', as it's only metadata that can 
    // be manipulated by the end-user. Consider the 'Utilities.IsFileValid' method 
    // that takes an 'IFormFile' and validates its signature within the 
    // 'AllowedFileSignatures'.

    var fileSaveName = Guid.NewGuid().ToString("N") + 
        Path.GetExtension(file.FileName);
    await SaveFileWithCustomFileName(file, fileSaveName);

    context.Response.Headers.Append("Location", linker.GetPathByName(context, 
        "GetFileByName", new { fileName = fileSaveName}));

    return TypedResults.Ok("File Uploaded Successfully!");
})
.RequireAuthorization("AdminsOnly");

在 Startup.ConfigureServices 中：

services.AddAuthorization(options =>
{
    options.AddPolicy("AuthenticatedUsers", b => b.RequireAuthenticatedUser());
});

在 Startup.Configure 中：

app.MapGet("/files/{fileName}", IResult (string fileName) => 
{
    var filePath = GetOrCreateFilePath(fileName);

    if (File.Exists(filePath))
    {
        return TypedResults.PhysicalFile(filePath, fileName);
    }

    return TypedResults.NotFound("No file found with the supplied file name");
})
.WithName("GetFileByName")
.RequireAuthorization("AuthenticatedUsers");

以下程式碼會上傳管理員角色admin（）中已認證使用者的檔案。

在 Startup.ConfigureServices 中：

services.AddAuthorization(options =>
{
    options.AddPolicy("AdminsOnly", b => b.RequireRole("admin"));
});

在 Startup.Configure 中：

// IFormFile uses memory buffer for uploading. For handling large 
// files, use streaming instead. See the *File uploads* article
// in the ASP.NET Core documentation:
// https://learn.microsoft.com/aspnet/core/mvc/models/file-uploads
app.MapPost("/files", async (IFormFile file, LinkGenerator linker, 
    HttpContext context) =>
{
    // Don't rely on the value in 'file.FileName', as it's only metadata that can 
    // be manipulated by the end-user. Consider the 'Utilities.IsFileValid' method 
    // that takes an 'IFormFile' and validates its signature within the 
    // 'AllowedFileSignatures'.

    var fileSaveName = Guid.NewGuid().ToString("N") + 
        Path.GetExtension(file.FileName);
    await SaveFileWithCustomFileName(file, fileSaveName);

    context.Response.Headers.Append("Location", linker.GetPathByName(context, 
        "GetFileByName", new { fileName = fileSaveName}));

    return TypedResults.Ok("File Uploaded Successfully!");
})
.RequireAuthorization("AdminsOnly");

下列 API 的命名空間：

using Microsoft.AspNetCore.StaticFiles;
using Microsoft.Extensions.FileProviders;

服務報名：

builder.Services.AddDirectoryBrowser();

在請求處理流程中，在對現有呼叫MapStaticAssets（.NET 9或更新版本）或UseStaticFiles（.NET 8或更早版本）之後：

var fileProvider = new PhysicalFileProvider(
    Path.Combine(builder.Environment.WebRootPath, "images"));
var requestPath = "/DirectoryImages";

app.UseStaticFiles(new StaticFileOptions
{
    FileProvider = fileProvider,
    RequestPath = requestPath
});

app.UseDirectoryBrowser(new DirectoryBrowserOptions
{
    FileProvider = fileProvider,
    RequestPath = requestPath
});

下列 API 的命名空間：

using Microsoft.Extensions.FileProviders;
using System.IO;

在 Startup.ConfigureServices 中：

services.AddDirectoryBrowser();

在Startup.Configure中，於現有對UseStaticFiles的呼叫之後：

app.UseStaticFiles(new StaticFileOptions
{
    FileProvider = new PhysicalFileProvider(
        Path.Combine(env.WebRootPath, "images")),
    RequestPath = "/DirectoryImages"
});

app.UseDirectoryBrowser(new DirectoryBrowserOptions
{
    FileProvider = new PhysicalFileProvider(
        Path.Combine(env.WebRootPath, "images")),
    RequestPath = "/DirectoryImages"
});

AddDirectoryBrowser 新增目錄瀏覽中介軟體所需的服務，包括 HtmlEncoder。 這些服務可能已透過其他呼叫新增，例如 AddRazorPages，但仍請呼叫 AddDirectoryBrowser 以確保這些服務已新增。

因為 MapStaticAssets 服務的是建置時透過端點路由發現的資產，它不會單獨提供預設文件。 呼叫 UseDefaultFiles 來重寫請求，接著呼叫 UseStaticFiles，為預設文件提供重寫後的請求：

app.UseDefaultFiles();
app.UseStaticFiles();
app.MapStaticAssets();

在請求處理管線中，於現有的 UseStaticFiles 呼叫之前：

app.UseDefaultFiles();

服務報名：

builder.Services.AddDirectoryBrowser();

在請求處理管線中，於現有對 UseStaticFiles 的呼叫之後：

app.UseFileServer(enableDirectoryBrowsing: true);

在 Startup.ConfigureServices 中：

services.AddDirectoryBrowser();

在Startup.Configure中，於現有對UseStaticFiles的呼叫之後：

app.UseFileServer(enableDirectoryBrowsing: true);

下列 API 的命名空間：

using Microsoft.Extensions.FileProviders;

服務報名：

builder.Services.AddDirectoryBrowser();

在請求處理管線中，於現有對 UseStaticFiles 的呼叫之後：

app.UseFileServer(new FileServerOptions
{
    FileProvider = new PhysicalFileProvider(
        Path.Combine(builder.Environment.ContentRootPath, "ExtraStaticFiles")),
    RequestPath = "/static-files",
    EnableDirectoryBrowsing = true
});

下列 API 的命名空間：

using Microsoft.Extensions.FileProviders;
using System.IO;

在 Startup.ConfigureServices 中：

services.AddDirectoryBrowser();

在Startup.Configure中，於現有對UseStaticFiles的呼叫之後：

app.UseFileServer(new FileServerOptions
{
    FileProvider = new PhysicalFileProvider(
        Path.Combine(env.ContentRootPath, "ExtraStaticFiles")),
    RequestPath = "/static-files",
    EnableDirectoryBrowsing = true
});

using Microsoft.AspNetCore.StaticFiles;
using Microsoft.Extensions.FileProviders;

...

// Set up custom content types - associating file extension to MIME type
var provider = new FileExtensionContentTypeProvider();
// Add new mappings
provider.Mappings[".myapp"] = "application/x-msdownload";
provider.Mappings[".htm3"] = "text/html";
provider.Mappings[".image"] = "image/png";
// Replace an existing mapping
provider.Mappings[".rtf"] = "application/x-msdownload";
// Remove MP4 videos
provider.Mappings.Remove(".mp4");

app.UseStaticFiles(new StaticFileOptions
{
    ContentTypeProvider = provider
});

若有多個靜態檔案選項要設定，您也可以改為使用 StaticFileOptions 來設定提供者：

var provider = new FileExtensionContentTypeProvider();

...

builder.Services.Configure<StaticFileOptions>(options =>
{
    options.ContentTypeProvider = provider;
});

app.UseStaticFiles();

在 Startup.Configure 中：

using Microsoft.AspNetCore.StaticFiles;
using Microsoft.Extensions.FileProviders;
using System.IO;

...

// Set up custom content types - associating file extension to MIME type
var provider = new FileExtensionContentTypeProvider();
// Add new mappings
provider.Mappings[".myapp"] = "application/x-msdownload";
provider.Mappings[".htm3"] = "text/html";
provider.Mappings[".image"] = "image/png";
// Replace an existing mapping
provider.Mappings[".rtf"] = "application/x-msdownload";
// Remove MP4 videos
provider.Mappings.Remove(".mp4");

app.UseStaticFiles(new StaticFileOptions
{
    FileProvider = new PhysicalFileProvider(
        Path.Combine(env.WebRootPath, "images")),
    RequestPath = "/images",
    ContentTypeProvider = provider
});

app.UseDirectoryBrowser(new DirectoryBrowserOptions
{
    FileProvider = new PhysicalFileProvider(
        Path.Combine(env.WebRootPath, "images")),
    RequestPath = "/images"
});

提供自訂靜態檔案資訊清單

如果staticAssetsManifestPath是null，那麼IHostEnvironment.ApplicationName會用來定位資訊清單。 或者，指定資訊清單檔案的完整路徑。 如果你使用相對路徑，框架會在 AppContext.BaseDirectory 中搜尋該檔案。

MSBuild 屬性

下列表格顯示靜態檔案相關的 MSBuild 屬性及其中繼資料描述。

以下範例排除了 JavaScript 檔案的壓縮範圍：

<PropertyGroup>
  <CompressionExcludePatterns>$(CompressionExcludePatterns);**\*.js</CompressionExcludePatterns>
</PropertyGroup>

要完全關閉靜態資產壓縮：

<PropertyGroup>
  <CompressionEnabled>false</CompressionEnabled>
</PropertyGroup>

元資料描述：

• Pattern：用於比對檔案的 glob 模式。 對於 StaticWebAssetContentTypeMapping，它會比對檔案以判斷其內容類型 （例如， *.js JavaScript 檔案）。 對於 StaticWebAssetFingerprintPattern，它會識別包含多種副檔名的檔案，這些檔案需要特殊的指紋處理（例如 *.lib.module.js）。

• Cache：指定 Cache-Control 相符內容類型的標頭值。 此值控制瀏覽器快取行為（例如 max-age=3600, must-revalidate 媒體檔案）。

• Priority： 控制多個 StaticWebAssetContentTypeMapping 項目匹配同一檔案時的優先順序。 較高的數值優先於較低的數值。 Priority 是必要的。

• Expression：定義如何將指紋嵌入到檔案名稱中。 預設值為 #[.{FINGERPRINT}]，在副檔名之前插入指紋（{FINGERPRINT} 佔位符）。

下列範例將點陣圖檔案的模式（.bmp）對應到 image/bmp 內容類型，其中 {CACHE HEADER} 代表要用於非指紋端點的 Cache-Control 標頭：

<ItemGroup>
  <StaticWebAssetContentTypeMapping Include="image/bmp" Cache="{CACHE HEADER}"
    Pattern="*.bmp" Priority="1" />
</ItemGroup>

執行階段配置選項

下表說明執行階段組態選項。