当前位置：首页 > news >正文

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

news 2025/11/7 4:02:34

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

wwwroot文件夹概述

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

静态资源中间件

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

var builder = WebApplication.CreateBuilder(args);// Add services to the container.
builder.Services.AddControllersWithViews();var app = builder.Build();// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{app.UseExceptionHandler("/Home/Error");// The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.app.UseHsts();
}app.UseHttpsRedirection();//1. 启动静态资源服务中间件
app.UseStaticFiles();app.UseRouting();app.UseAuthorization();app.MapControllerRoute(name: "default",pattern: "{controller=Home}/{action=Index}/{id?}");app.Run();

静态资源示例

根据模板创建的ASP.NET Core MVC项目，直接运行，会通过路由设置，默认加载Home/Index页面，如下所示：

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

<!DOCTYPE html>
<html>
<head><meta charset="utf-8" /><title>静态首页</title>
</head>
<body><h1>公子小六</h1><h2>这是静态首页</h2>
</body>
</html>

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

var builder = WebApplication.CreateBuilder(args);
// Add services to the container.
builder.Services.AddControllersWithViews();
var app = builder.Build();
// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{app.UseExceptionHandler("/Home/Error");// The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.app.UseHsts();
}
app.UseHttpsRedirection();//0. 允许默认文件映射
app.UseDefaultFiles();
//1. 启动静态资源服务中间件
app.UseStaticFiles();app.UseRouting();
app.UseAuthorization();
app.MapControllerRoute(name: "default",pattern: "{controller=Home}/{action=Index}/{id?}");app.Run();

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

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

修改默认资源名称

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

var builder = WebApplication.CreateBuilder(args);
// Add services to the container.
builder.Services.AddControllersWithViews();
var app = builder.Build();
// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{app.UseExceptionHandler("/Home/Error");// The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.app.UseHsts();
}
app.UseHttpsRedirection();//默认文件启动项
DefaultFilesOptions options = new DefaultFilesOptions();
options.DefaultFileNames.Add("Hello.html");
//0. 允许默认文件映射
app.UseDefaultFiles(options);//1. 启动静态资源服务中间件
app.UseStaticFiles();app.UseRouting();
app.UseAuthorization();
app.MapControllerRoute(name: "default",pattern: "{controller=Home}/{action=Index}/{id?}");app.Run();

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

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

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

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

修改静态资源目录

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

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

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

注意：为了让wwwroot2生效，必须修改原有的wwwrooot文件名称或者删除wwwroot文件夹，否则wwwroot2将不生效。

客户端库

客户端库主要是指JavaScript，CSS等第三方库，在ASP.NET Core MVC项目中，安装客户端库如下所示：

在项目名称处右键，选择添加，客户端库，如下所示：

在打开的客户端库添加窗口，可以选择需要的库名称，进行搜索，然后进行安装即可，如下所示：

安装成功后，在目标位置即可进行查看，如下所示：

以上就是关于ASP.NET Core MVC项目中wwwroot和客户端库相关内容。关于客户端库在安装成功后，如何在页面中引用，将在后续章节中进行介绍。

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

wwwroot文件夹概述

静态资源中间件

静态资源示例

修改默认资源名称

修改静态资源目录

客户端库

相关文章：

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

Oracle OCI 修改 Compute Instance Hostname

垃圾收集算法面试总结

grep替换指定字符串方法

主从模式、哨兵模式、集群模式（cluster）

题目3180:蓝桥杯2023年第十四届省赛真题-互质数的个数======及探讨互质专题

Java 文件操作

二叉树OJ题(C++实现)

grep -nr 命令查询字符串方式

AgentAI+ChatGPT给出答案-为什么即时通讯需要心跳

跨平台跨端的登录流程及其安全设计

如何在Java中创建临时文件？

Vue表单基本操作-收集表单数据

Android 一个获取网址时间的Demo

ijkplayer解码流程源码解读

2023年值得关注的3个品牌趋势，帮你弯道超车

软考-高级项目管理(二十)

RTMP协议深度解析：从原理到实践，掌握实时流媒体传输技术

2023mathorcup数学建模ABCD思路分析

普通家庭，千万不要投入大量时间和金钱，让孩子去苦学和培养AI机器人编程了...

XML Group端口详解

【Linux】shell脚本忽略错误继续执行

Vue3 + Element Plus + TypeScript中el-transfer穿梭框组件使用详解及示例

srs linux

Nuxt.js 中的路由配置详解

Cloudflare 从 Nginx 到 Pingora：性能、效率与安全的全面升级

Neo4j 集群管理：原理、技术与最佳实践深度解析

（转）什么是DockerCompose?它有什么作用？

什么？连接服务器也能可视化显示界面？：基于X11 Forwarding + CentOS + MobaXterm实战指南

（一）单例模式