如何为IIS Express上的WebForms应用注册全局自定义目录浏览处理器？

方法1：通过web.config直接映射自定义HttpHandler #

先编写自定义的目录处理类，替换默认IIS目录列表逻辑：

using System.Web;
using System.IO;

public class CustomDirectoryHandler : IHttpHandler
{
    public bool IsReusable => true;

    public void ProcessRequest(HttpContext context)
    {
        // 获取当前请求对应的物理目录路径
        string physicalDir = context.Server.MapPath(context.Request.Path);
        var dirInfo = new DirectoryInfo(physicalDir);

        // 输出自定义目录页面
        context.Response.ContentType = "text/html";
        context.Response.Write($"<h2>自定义目录：{context.Request.Path}</h2>");
        context.Response.Write("<ul>");

        // 遍历子目录
        foreach (var subDir in dirInfo.GetDirectories())
        {
            string dirUrl = $"{context.Request.Path.TrimEnd('/')}/{subDir.Name}/";
            context.Response.Write($"<li><a href='{dirUrl}'>📁 {subDir.Name}</a></li>");
        }

        // 遍历文件
        foreach (var file in dirInfo.GetFiles())
        {
            string fileUrl = $"{context.Request.Path.TrimEnd('/')}/{file.Name}";
            context.Response.Write($"<li><a href='{fileUrl}'>📄 {file.Name} ({file.Length} bytes)</a></li>");
        }

        context.Response.Write("</ul>");
    }
}

接着在web.config中配置，覆盖默认目录处理逻辑：

针对IIS集成管道（IIS Express默认模式） #

<system.webServer>
  <!-- 移除默认的目录浏览模块，避免冲突 -->
  <remove name="DirectoryListingModule" />
  <!-- 注册自定义处理器，匹配所有以/结尾的目录请求 -->
  <handlers>
    <add 
      name="CustomDirectoryHandler" 
      verb="*" 
      path="*/" 
      type="CustomDirectoryHandler" 
      modules="ManagedPipelineHandler" 
      preCondition="integratedMode" 
    />
  </handlers>
  <!-- 保持directoryBrowse启用，确保目录可访问 -->
  <directoryBrowse enabled="true" />
</system.webServer>

针对传统ASP.NET管道（可选） #

<system.web>
  <httpHandlers>
    <add verb="*" path="*/" type="CustomDirectoryHandler" />
  </httpHandlers>
</system.web>

方法2：用HttpModule灵活拦截目录请求 #

如果需要根据条件触发自定义处理（比如仅处理特定目录），可以用HttpModule：

using System.Web;
using System.IO;

public class DirectoryInterceptorModule : IHttpModule
{
    public void Init(HttpApplication context)
    {
        context.BeginRequest += OnBeginRequest;
    }

    private void OnBeginRequest(object sender, EventArgs e)
    {
        var app = (HttpApplication)sender;
        var context = app.Context;
        string physicalPath = context.Server.MapPath(context.Request.Path);

        // 判断当前请求是否指向存在的目录
        if (Directory.Exists(physicalPath))
        {
            // 转发请求到自定义处理器
            context.RemapHandler(new CustomDirectoryHandler());
        }
    }

    public void Dispose() { }
}

然后在web.config注册模块：

<system.webServer>
  <modules>
    <add 
      name="DirectoryInterceptorModule" 
      type="DirectoryInterceptorModule" 
      preCondition="integratedMode" 
    />
  </modules>
  <directoryBrowse enabled="true" />
</system.webServer>

关键注意事项 #

• 如果自定义类在命名空间下，type属性要写完整路径（比如YourAppNamespace.CustomDirectoryHandler）
• 修改配置后需重启IIS Express才能生效
• 若要限制仅处理特定目录，可修改path属性（比如/Public/*/）
• 测试时确保请求的目录存在，且未被其他路由或处理器拦截

内容的提问来源于stack exchange，提问作者DELTA12