ASP.NET Core MVC 从入门到精通之wwwroot和客户端库已关闭评论
239 次浏览

A+

所属分类：.NET技术

摘要

随着技术的发展，ASP.NET Core MVC也推出了好长时间，经过不断的版本更新迭代，已经越来越完善，本系列文章主要讲解ASP.NET Core MVC开发B/S系统过程中所涉及到的相关内容，适用于初学者，在校毕业生，或其他想从事ASP.NET Core MVC 系统开发的人员。经过前几篇文章的讲解，初步了解ASP.NET Core MVC项目创建，启动运行，以及命名约定，创建控制器，视图，模型，接收参数，传递数据，路由，页面布局等内容，今天继续讲解ASP.NET Core MVC wwwroot和客户端库等相关内容，仅供学习分享使用。

便宜好用的国外VPS推荐

随着技术的发展，ASP.NET Core MVC也推出了好长时间，经过不断的版本更新迭代，已经越来越完善，本系列文章主要讲解ASP.NET Core MVC开发B/S系统过程中所涉及到的相关内容，适用于初学者，在校毕业生，或其他想从事ASP.NET Core MVC 系统开发的人员。经过前几篇文章的讲解，初步了解ASP.NET Core MVC项目创建，启动运行，以及命名约定，创建控制器，视图，模型，接收参数，传递数据，路由，页面布局等内容，今天继续讲解ASP.NET Core MVC wwwroot和客户端库等相关内容，仅供学习分享使用。

ASP.NET Core MVC 从入门到精通之wwwroot和客户端库

wwwroot文件夹概述

通过模板创建的ASP.NET Core MVC项目，会在程序根目录创建一个wwwroot文件夹。此文件夹又称为webroot文件夹，主要用于存放静态资源文件，如：html，JavaScript，css样式等内容。默认情况下，存在wwwroot文件夹下的所有静态资源都可以通过Http请求提供服务。在新的框架中，且只有存放于wwwroot目录下的静态资源可以直接通过Http访问，其他目录下的静态资源都将阻止。

静态资源中间件

为了使wwwroot目录下的静态资源能够被Http直接访问，需要在程序启动时【Program.cs】加载静态资源中间件。如下所示：

 1 var builder = WebApplication.CreateBuilder(args);  2   3 // Add services to the container.  4 builder.Services.AddControllersWithViews();  5   6 var app = builder.Build();  7   8 // Configure the HTTP request pipeline.  9 if (!app.Environment.IsDevelopment()) 10 { 11     app.UseExceptionHandler("/Home/Error"); 12     // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts. 13     app.UseHsts(); 14 } 15  16 app.UseHttpsRedirection(); 17  18 //1. 启动静态资源服务中间件 19 app.UseStaticFiles(); 20  21 app.UseRouting(); 22  23 app.UseAuthorization(); 24  25 app.MapControllerRoute( 26     name: "default", 27     pattern: "{controller=Home}/{action=Index}/{id?}"); 28  29 app.Run();

静态资源示例

创建程序后，直接运行，会通过路由设置，默认加载Home/Index页面，如下所示：

ASP.NET Core MVC 从入门到精通之wwwroot和客户端库

在wwwroot目录下，创建index.html，内容如下所示：

 1 <!DOCTYPE html>  2 <html>  3 <head>  4     <meta charset="utf-8" />  5     <title>静态首页</title>  6 </head>  7 <body>  8     <h1>公子小六</h1>  9     <h2>这是静态首页</h2> 10 </body> 11 </html>

在Program.cs启动文件中，添加默认文件中间件【app.UseDefaultFiles();】，如下所示：

 1 var builder = WebApplication.CreateBuilder(args);  2 // Add services to the container.  3 builder.Services.AddControllersWithViews();  4 var app = builder.Build();  5 // Configure the HTTP request pipeline.  6 if (!app.Environment.IsDevelopment())  7 {  8     app.UseExceptionHandler("/Home/Error");  9     // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts. 10     app.UseHsts(); 11 } 12 app.UseHttpsRedirection(); 13  14  15 //0. 允许默认文件映射 16 app.UseDefaultFiles(); 17 //1. 启动静态资源服务中间件 18 app.UseStaticFiles(); 19  20  21 app.UseRouting(); 22 app.UseAuthorization(); 23 app.MapControllerRoute( 24     name: "default", 25     pattern: "{controller=Home}/{action=Index}/{id?}"); 26  27 app.Run();

再次运行程序，会发现静态默认首页Index.html会替换之前默认的Home/Index路由视图，如下所示：

ASP.NET Core MVC 从入门到精通之wwwroot和客户端库

通过以上示例得出在结论：默认静态资源首页优先级高于默认路由。

修改默认资源名称

默认启动静态资源名称为Index.html，可以通过DefaultFilesOptions指定默认的首页加载顺序和名称。如下所示：

 1 var builder = WebApplication.CreateBuilder(args);  2 // Add services to the container.  3 builder.Services.AddControllersWithViews();  4 var app = builder.Build();  5 // Configure the HTTP request pipeline.  6 if (!app.Environment.IsDevelopment())  7 {  8     app.UseExceptionHandler("/Home/Error");  9     // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts. 10     app.UseHsts(); 11 } 12 app.UseHttpsRedirection(); 13  14 //默认文件启动项 15 DefaultFilesOptions options = new DefaultFilesOptions(); 16 options.DefaultFileNames.Add("Hello.html"); 17 //0. 允许默认文件映射 18 app.UseDefaultFiles(options); 19  20 //1. 启动静态资源服务中间件 21 app.UseStaticFiles(); 22  23 app.UseRouting(); 24 app.UseAuthorization(); 25 app.MapControllerRoute( 26     name: "default", 27     pattern: "{controller=Home}/{action=Index}/{id?}"); 28  29 app.Run();

修改后再次启动，发现加载的依然是Index.html，而不是Hello.html。经过调试发现，DefaultFilesOptions的默认加载页面，会自动填充4个默认页面名称。后面添加的页面名称会在原有默认页面之后。如下所示：

ASP.NET Core MVC 从入门到精通之wwwroot和客户端库

经过以上分析，删除默认的index.html页面，重新启动，默认首页变成了Hello.html页面，如下所示：

ASP.NET Core MVC 从入门到精通之wwwroot和客户端库

静态资源文件除了可以通过静态资源中间件来实现【app.UseStaticFiles()】，还可以通过文件服务中间件来实现，如下所示：

1 FileServerOptions options = new FileServerOptions(); 2 options.DefaultFilesOptions.DefaultFileNames.Add("Hello.html"); 3 app.UseFileServer(options);

修改静态资源目录

默认的静态资源目录为wwwroot，一般也是通用的webroot文件夹名称，如果需要修改成其他目录，可以通过WebApplication.CreateBuilder(options)中的选项进行修改，接线所示：

1 WebApplicationOptions weboptions = new WebApplicationOptions() { WebRootPath="wwwroot2" }; 2 var builder = WebApplication.CreateBuilder(weboptions);

修改后，重新运行程序，如下所示：

ASP.NET Core MVC 从入门到精通之wwwroot和客户端库