ASP.NET Core 5.0 MVC 视图组件的用法

2023-10-21 18:22:16 浏览数 (1)

什么是视图组件

视图组件与分部视图类似,但它们的功能更加强大。 视图组件不使用模型绑定,并且仅依赖调用时提供的数据。它也适用于 Razor 页。

视图组件:

  • 呈现一个区块而不是整个响应。
  • 包括控制器和视图间发现的相同关注点分离和可测试性优势。
  • 可以有参数和业务逻辑。
  • 通常从布局页调用。

视图组件可用于具有可重用呈现逻辑(对分部视图来说过于复杂)的任何位置,例如:

  • 动态导航菜单
  • 标记云(查询数据库的位置)
  • 登录面板
  • 购物车
  • 最近发布的文章
  • 典型博客上的边栏内容
  • 一个登录面板,呈现在每页上并显示注销或登录链接,具体取决于用户的登录状态

视图组件由两部分组成:类(通常派生自 ViewComponent)及其返回的结果(通常为视图)。

创建ViewCompont组件类

创建一个 ViewComponents 文件夹并添加以下 PriorityListViewComponent 类

代码语言:javascript复制
  public class PriorityListViewComponent :  ViewComponent
    {
        public async Task<IViewComponentResult> InvokeAsync(int maxPriority, bool isDone)
        {
            var items = await GetItemsAsync(maxPriority, isDone);
            return View(items);
        }
        private Task<List<TodoItem>> GetItemsAsync(int maxPriority, bool isDone)
        {
            return Task.Run<List<TodoItem>>(() =>
            {

                return new List<TodoItem>()
                {
                      new TodoItem(){
                            Id=123,
                            Name="孙思邈",
                            Age=6,
                            Description="药王、妙应真人、孙十常、白山药王 "
                      },
                       new TodoItem(){
                            Id=456,
                            Name="孙思邈",
                            Age=7,
                            Description="药王、妙应真人、孙十常、白山药王 "
                      },
                       new TodoItem(){
                            Id=789,
                            Name="孙思邈",
                            Age=8,
                            Description="药王、妙应真人、孙十常、白山药王 "
                      },
                      new TodoItem(){
                            Id=12,
                            Name="孙思邈",
                            Age=9,
                            Description="药王、妙应真人、孙十常、白山药王"
                      }
                };
            });
        }
    }
代码语言:javascript复制
    public class TodoItem
    {
        public int Id { get; set; }

        public string Name { get; set; }

        public int Age { get; set; }

        public string Description { get; set; }
    }

创建视图组件 Razor 视图

  • 创建 Views/Shared/Components 文件夹。 此文件夹 必须 命名为 Components
  • 创建 Views/Shared/Components/PriorityList 文件夹。 此文件夹名称必须与视图组件类的名称或类名去掉后缀(如果遵照约定并在类名中使用了“ViewComponent”后缀)的名称相匹配。 如果使用了 ViewComponent 属性,则类名称需要匹配指定的属性。
  •    创建 Views/Shared/Components/PriorityList/Default ... Razor view:
代码语言:javascript复制
@model IEnumerable<TodoItem>

<h3>Priority Items</h3>
<ul>
    @foreach (var todo in Model)
    {
        <li>@todo.Name</li>
    }
</ul>

 使用组件视图

在详情Index视图上,引用组件视图

代码语言:javascript复制
<div>
    @await Component.InvokeAsync("PriorityList", new { maxPriority = 2, isDone = false })
</div>

 效果图

0 人点赞