ASP.Net项目中如何向布局页的通用控件传递数据？

这个问题我之前做社交类项目的时候也碰到过，用基类模型确实会让所有页面的模型都被迫继承，时间长了模型会臃肿不堪，维护起来特别麻烦。给你几个实用的方案，你可以根据项目规模和需求来选：

1. 用ViewComponent（最推荐，解耦性拉满） #

ASP.NET Core里的ViewComponent就是专门为这种独立的、需要获取数据的共享控件设计的，完全不需要依赖页面的模型，每个控件自己搞定数据逻辑，完美解决模型膨胀的问题。

举个好友列表的例子：

• 首先创建一个ViewComponent类，负责获取好友数据：

public class FriendListViewComponent : ViewComponent
{
    private readonly IFriendService _friendService;

    // 依赖注入你的业务服务
    public FriendListViewComponent(IFriendService friendService)
    {
        _friendService = friendService;
    }

    // 核心方法，返回控件的视图和数据
    public async Task<IViewComponentResult> InvokeAsync()
    {
        // 这里获取当前登录用户的好友列表，逻辑自己实现
        var currentUserId = User.FindFirstValue(ClaimTypes.NameIdentifier);
        var friends = await _friendService.GetUserFriendsAsync(currentUserId);
        return View(friends);
    }
}

• 然后在Views/Shared/Components/FriendList/Default.cshtml创建对应的视图，直接用模型渲染好友列表：

<ul class="friend-list">
    @foreach (var friend in Model)
    {
        <li>@friend.Name</li>
    }
</ul>

• 最后在布局页里直接调用这个ViewComponent就行，完全不用管页面本身的模型：

<div class="right-sidebar">
    @await Component.InvokeAsync("FriendList")
</div>

这种方式的好处是每个控件独立，可测试，就算以后加新的共享控件（比如消息通知、热门推荐），直接加新的ViewComponent就行，完全不影响现有页面的模型。

2. 用Action过滤器+ViewData/ViewBag（快速实现，适合小项目） #

如果项目比较小，不想搞太复杂的结构，可以用Action过滤器提前把共享数据放到ViewData里，然后在局部视图里取出来用。

比如创建一个过滤器：

public class LoadSharedDataFilter : IAsyncActionFilter
{
    private readonly IFriendService _friendService;

    public LoadSharedDataFilter(IFriendService friendService)
    {
        _friendService = friendService;
    }

    public async Task OnActionExecutionAsync(ActionExecutingContext context, ActionExecutionDelegate next)
    {
        // 先执行Action，再处理数据
        var resultContext = await next();
        
        if (resultContext.Result is ViewResult viewResult)
        {
            var currentUserId = context.HttpContext.User.FindFirstValue(ClaimTypes.NameIdentifier);
            // 把好友数据放到ViewData里
            viewResult.ViewData["FriendList"] = await _friendService.GetUserFriendsAsync(currentUserId);
            // 还可以加其他共享数据，比如通知数
            // viewResult.ViewData["UnreadNotifications"] = await _notificationService.GetUnreadCountAsync(currentUserId);
        }
    }
}

然后在Startup里注册这个过滤器，让它全局生效：

services.AddControllersWithViews(options =>
{
    options.Filters.Add<LoadSharedDataFilter>();
});

最后在布局页的局部视图里直接用ViewData：

<ul class="friend-list">
    @foreach (var friend in (List<Friend>)ViewData["FriendList"])
    {
        <li>@friend.Name</li>
    }
</ul>

这个方法的缺点是类型不安全，如果ViewData的键写错了或者类型转换错了，运行时才会报错，大型项目不推荐，但小项目快速实现很方便。

3. 自定义Tag Helper（适合需要自定义HTML属性的场景） #

如果你的共享控件需要支持自定义HTML属性（比如控制显示数量、样式），可以用Tag Helper来实现，本质上和ViewComponent类似，但更偏向于HTML标签的扩展。

比如创建一个FriendListTagHelper：

[HtmlTargetElement("friend-list")]
public class FriendListTagHelper : TagHelper
{
    private readonly IFriendService _friendService;
    private readonly IHttpContextAccessor _httpContextAccessor;

    // 可以定义自定义属性，比如最多显示多少个好友
    public int MaxCount { get; set; } = 10;

    public FriendListTagHelper(IFriendService friendService, IHttpContextAccessor httpContextAccessor)
    {
        _friendService = friendService;
        _httpContextAccessor = httpContextAccessor;
    }

    public override async Task ProcessAsync(TagHelperContext context, TagHelperOutput output)
    {
        var currentUserId = _httpContextAccessor.HttpContext.User.FindFirstValue(ClaimTypes.NameIdentifier);
        var friends = await _friendService.GetUserFriendsAsync(currentUserId);
        // 应用MaxCount限制
        var limitedFriends = friends.Take(MaxCount).ToList();

        // 渲染视图内容
        var viewComponentResult = new ViewComponentResult
        {
            ViewName = "Default",
            ViewData = new ViewDataDictionary(new EmptyModelMetadataProvider(), new ModelStateDictionary())
            {
                Model = limitedFriends
            }
        };

        var writer = new StringWriter();
        await viewComponentResult.ExecuteAsync(new ViewContext
        {
            Writer = writer,
            HttpContext = _httpContextAccessor.HttpContext,
        });

        output.Content.SetHtmlContent(writer.ToString());
    }
}

然后在布局页里直接用自定义标签：

<div class="right-sidebar">
    <friend-list max-count="8"></friend-list>
</div>

这个方式适合需要灵活配置的控件，但实现起来比ViewComponent稍微复杂一点。

总的来说，ViewComponent是最优解，它是ASP.NET官方推荐的共享控件方案，解耦性好、可维护性高，完全不会让页面模型膨胀。如果是小项目快速迭代，用过滤器+ViewData也能凑合用，但长远来看还是ViewComponent更靠谱。

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