ASP.NET Core中ViewBag动态控制器标题不显示原因及最优实现方案

一、ViewBag.HeaderTitle不显示的原因 #

你在控制器构造函数中调用SetHeaderTitle无效的核心原因是：ASP.NET Core控制器生命周期中，构造函数执行时，与当前请求绑定的ViewBag（本质是ViewData的动态包装）尚未初始化。

控制器实例在请求开始时创建，但构造函数执行阶段，控制器的ControllerContext还未被赋值，而ViewBag依赖于ControllerContext中的ViewDataDictionary。此时对ViewBag的赋值不会关联到当前请求上下文，自然无法传递到Razor视图中。

二、为每个控制器设置不同页头标题的最佳方案 #

推荐两种可靠且避免重复代码的方案，可根据场景选择：

方案1：利用基类的OnActionExecuting方法（简单直接） #

重写基类的OnActionExecuting方法（该方法在每个Action执行前触发，此时请求上下文已初始化，ViewBag可用），让派生控制器提供固定标题属性：

1. 修改基类BaseController：

public abstract class BaseController : Controller
{
    // 让派生控制器实现该属性，返回对应页头标题
    protected abstract string HeaderTitle { get; }

    public override void OnActionExecuting(ActionExecutingContext context)
    {
        // 在Action执行前设置ViewBag
        ViewBag.HeaderTitle = HeaderTitle;
        base.OnActionExecuting(context);
    }
}

2. 派生控制器实现：

public class MaterialConstantNumbersController : BaseController
{
    private const string _headerName = "Constant numbers section";
    // 实现基类的抽象属性
    protected override string HeaderTitle => _headerName;

    public MaterialConstantNumbersController(IMediator mediator) : base(mediator)
    {
    }
}

这种方案无需额外配置，逻辑清晰，适合每个控制器标题固定的场景。

方案2：自定义特性+Action过滤器（灵活扩展） #

如果需要支持控制器级别或Action级别的不同标题，可使用自定义特性配合过滤器，扩展性更强：

1. 定义标题特性：

[AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = false)]
public class HeaderTitleAttribute : Attribute
{
    public string Title { get; }

    public HeaderTitleAttribute(string title)
    {
        Title = title;
    }
}

2. 实现Action过滤器：

public class HeaderTitleFilter : IActionFilter
{
    public void OnActionExecuting(ActionExecutingContext context)
    {
        if (context.Controller is not Controller controller) return;

        // 优先读取Action上的标题特性
        var actionTitleAttr = context.ActionDescriptor.EndpointMetadata
            .OfType<HeaderTitleAttribute>()
            .FirstOrDefault();
        
        if (actionTitleAttr != null)
        {
            controller.ViewBag.HeaderTitle = actionTitleAttr.Title;
            return;
        }

        // 读取控制器上的标题特性
        var controllerTitleAttr = context.Controller.GetType()
            .GetCustomAttribute<HeaderTitleAttribute>();
        
        if (controllerTitleAttr != null)
        {
            controller.ViewBag.HeaderTitle = controllerTitleAttr.Title;
        }
    }

    public void OnActionExecuted(ActionExecutedContext context)
    {
        // 无需处理后续逻辑
    }
}

3. 注册过滤器（在Program.cs中）：

builder.Services.AddControllersWithViews(options =>
{
    // 添加自定义过滤器
    options.Filters.Add<HeaderTitleFilter>();
});

4. 在控制器/Action上标记特性：

// 控制器级别设置标题
[HeaderTitle("Constant numbers section")]
public class MaterialConstantNumbersController : BaseController
{
    public MaterialConstantNumbersController(IMediator mediator) : base(mediator)
    {
    }

    // 单个Action可覆盖控制器标题
    [HeaderTitle("特定页面标题")]
    public IActionResult SpecialPage()
    {
        return View();
    }
}

这种方案支持更细粒度的标题控制，适合有特殊Action需要不同标题的场景。

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