默認情況下昆码,Asp.Net Core 應用程序不會提供靜態(tài)文件。
靜態(tài)文件的默認目錄是wwwroot,此目錄必須位于項目文件夾的根目錄中憔四。
將圖片復制并粘貼到 wwwroot 文件夾中。我們假設文件的名稱是 banner.jpg般眉。為了能夠從瀏覽器訪問此文件了赵,路徑為:http://{{serverName}}/banner.jpg在我們的示例中,我們在本地計算機上運行甸赃, 因此 URL 將如下所示柿汛。您的計算機上的端口號可能不同。http://localhost:3290/banner.jpg埠对。
從我的電腦络断,然后導航到上面的 Url 的時候,
我們?nèi)匀皇峭ㄟ^Run()方法的中間件项玛,返回響應的結果貌笨,。我沒有看到圖片banner.jpg稍计。
這是因為躁绸,目前我們的應用程序請求處理管道,沒有可以提供靜態(tài)文件的所需中間件臣嚣。我們需要使用的中間件UseStaticFiles()净刮。
修改Configure()方法中的代碼,將UseStaticFiles()中間件添加到我們的應用程序的請求處理管道中硅则,如下所示淹父。
public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
? ? if (env.IsDevelopment())
? ? {
? ? ? ? app.UseDeveloperExceptionPage();
? ? }
? ? //添加靜態(tài)文件中間件
? ? app.UseStaticFiles();
? ? app.Run(async (context) =>
? ? {
? ? ? ? await context.Response.WriteAsync("Hello World!");
? ? });
}
提供 wwwroot 文件夾之外的靜態(tài)文件
默認情況下,UseStaticFiles()中間件僅提供 wwwroot 文件夾中的靜態(tài)文件怎虫。如果您愿意暑认,我們還可以在wwwroot文件夾之外提供靜態(tài)文件。
提供默認文檔
大多數(shù) Web 程序都有一個默認文檔大审,它是用戶訪問程序地址時顯示的文檔內(nèi)容蘸际。例如,您有一個名為default.html的文件徒扶,并且您希望在用戶訪問應用程序的根 URL 時提供它粮彤,即http://localhost:3290
此時,我們來訪問這個地址看看,我看到我使用Run()方法注冊的中間件產(chǎn)生的回調(diào)导坟。但是我沒有看到默認文檔default.html的內(nèi)容屿良。為了能夠提供默認頁面,我們必須在應用程序的請求處理管道中插入UseDefaultFiles()中間件惫周。
//添加默認文件中間件
app.UseDefaultFiles();
//添加靜態(tài)文件中間件
app.UseStaticFiles();
請注意:必須在UseStaticFiles之前,注冊UseDefaultFiles來提供默認文件尘惧。UseDefaultFiles是一個 URL 重寫器,實際上并沒有提供文件递递。它只是將URL重寫定位到默認文檔喷橙,然后還是由靜態(tài)文件中間件提供。地址欄中顯示的 URL 仍然是根節(jié)點的 URL登舞,而不是重寫的 URL重慢。
以下是UseDefaultFiles中間件默認會去查找的地址信息
- index.htm 的默認文件
- index.html
- default.htm
- default.html
如果要使用其他文檔,如 52abp.html 例如逊躁,作為您的默認文檔,您可以使用以下代碼執(zhí)行此操作隅熙。
//將52abp.html指定為默認文檔
DefaultFilesOptions defaultFilesOptions = new DefaultFilesOptions();
defaultFilesOptions.DefaultFileNames.Clear();
defaultFilesOptions.DefaultFileNames.Add(“52abp.html”);
//添加默認文件中間件
app.UseDefaultFiles(defaultFilesOptions);
//添加靜態(tài)文件中間件
app.UseStaticFiles();
UseFileServer 中間件
UseFileServer結合了UseStaticFiles稽煤,UseDefaultFiles和UseDirectoryBrowser中間件的功能。DirectoryBrowser中間件囚戚,支持目錄瀏覽酵熙,并允許用戶查看指定目錄中的文件。
我們可以用UseFileServer 中間件替換UseStaticFiles 和 UseDefaultFiles中間件驰坊。
/使用UseFileServer而不是UseDefaultFiles和UseStaticFiles
FileServerOptions fileServerOptions = new FileServerOptions();
fileServerOptions.DefaultFilesOptions.DefaultFileNames.Clear();
fileServerOptions.DefaultFilesOptions.DefaultFileNames.Add(“52abp.html”);
app.UseFileServer(fileServerOptions);
這里要注意的知識點:是我們應該使用添加中間件的方式匾二,添加到應用程序的請求處理管道的方法。
在大多數(shù)情況下拳芙,我們使用以 USE 開頭的擴展方法添加中間件察藐。例如:
UseDeveloperExceptionPage()
UseDefaultFiles()
UseStaticFiles()
UseFileServer()
如果要自定義這些中間件組件,他有對應的可配置選項卡舟扎。參考下表:
中間件 選項對象
UseDeveloperExceptionPage DeveloperExceptionPageOptions
UseDefaultFiles DefaultFilesOptions
UseStaticFiles StaticFileOptions
UseFileServer FileServerOptions