N2CMS Mvc Examples 学习记录 (4) – 母版页和视图
看母版页和视图会看到很多呈现方面的细节，包括如何使用N2的一些工具类来生成导航菜单、站点路径，如何在页面中放一个Zone（用于容纳Parts），以及如何显示模型对象的数据。不过N2CMS的API文档不是很详细，甚至根本没有说明，有时候不容易想出来一些方法具体实现的什么功能。
1. 母版页（Site.Master）
（1）显示管理工具栏
1: <n2:SlidingCurtain runat="server">
2: <n2:DragDropControlPanel runat="server" />
3:
n2:SlidingCurtain>
加上这段代码，管理员登录后可以在页面左看到管理面板工具栏。
（2）生成导航菜单
1: <ul id="mainMenu">
2: <li><a href="<%= N2.Find.StartPage.Url %>">Home
a>
li>
3: <%= N2.Web.Tree.From(N2.Find.StartPage, 2).Filters(new N2.Collections.NavigationFilter()).ExcludeRoot(true)%>
4: <li><%= Html.ActionLink("Static controller", "Items", "Static", new { id = "from the menu" }, null)%>
li>
5:
ul>
N2.Find.StartPage获取到起始页（即首页）的内容项。
N2.Web.Tree.From从指定内容项（这里是起始页）开始查找树结果，查找的深度为2层，并从中用导航过滤器找到所有的内容项，再排除根（即起始页，这个已经显示过了），最后以LI呈现出来。
（3）左边栏内容
1: <div class="leftColumn">
2: <h2><%= N2.Utility.Evaluate(N2.Find.AtLevel(N2.Find.CurrentPage, N2.Find.StartPage, 2), "Title") %>
h2>
3: <ul>
4: <%= N2.Web.Tree.Between(N2.Find.CurrentPage, N2.Find.StartPage, true, 2).Filters(new N2.Collections.NavigationFilter()).ExcludeRoot(true) %>
5:
ul>
6: <% Html.DroppableZone("Left").Render(); %>
7:
div>
--/leftColumn-->
N2.Find.AtLevel(N2.Find.CurrentPage, N2.Find.StartPage, 2)，第一个参数（当前页）是终点（子结点），第二个参数（起始页）是起点（父结点），这两个参数构成了一个树，在这个树结构内从起点确定深度为2级的项，然后用N2.Utility.Evaluate尝试获取它的标题。
N2.Web.Tree.Between(N2.Find.CurrentPage, N2.Find.StartPage, true, 2)应该是找出前两个参数之间的项，第三个参数不是很理解，第四个参数表示开始的层次，这里是从第2层开始，即起始页将不在内。找出来的项不一定都要显示出来，比如新闻容器下的新闻项就不应该显示出来，另外这些项的根顶也不需要，所以后面的工作就是过滤和排除，最后把项用LI呈现。
最后的<% Html.DroppableZone("Left").Render; %>是在此处呈现一个名为"Left"的Zone，这里可以在管理界面中把TextPart放到这里。
（4）右边栏内容
1: <div class="rightColumn">
2: <p>
3: <% foreach(N2.ContentItem item in N2.Find.EnumerateBetween(N2.Find.StartPage, N2.Find.CurrentPage, false)) { %>
4: <%= N2.Web.Link.To(item) %> /
5: <% } %>
6: <%= N2.Utility.Evaluate(N2.Find.CurrentPage, "Title") %>
7:
p>
8: <asp:ContentPlaceHolder ID="MainContentPlaceHolder" runat="server">
9:
asp:ContentPlaceHolder>
10:
div>
--/rightColumn-->
N2.Find.EnumerateBetween(N2.Find.StartPage, N2.Find.CurrentPage, false)返回两个内容项之间的所有项的迭代（IEnumerable ），false排除了最深层的页面，即当前页面。<%= N2.Web.Link.To(item) %>显示到这些项的链接。最后显示当前页的标题：<%= N2.Utility.Evaluate(N2.Find.CurrentPage, “Titlt”) %>。
下面的占位符把呈现工作交给各个视图模板来实现了。
2. 视图模板
（1）Content/Index.aspx
1: <%@ Page Title="" Language="C#" MasterPageFile="~/Views/Shared/Site.Master" AutoEventWireup="true" Inherits="ViewPage
" %>
2: <%@ Import Namespace="MvcTest.Models"%>
3: <asp:Content ID="Content1" ContentPlaceHolderID="MainContentPlaceHolder" runat="server">
4: <h1>< %= Model.Title % >
h1>
5: < %= Model.Text % >
6:
asp:Content>
显示ContentPage中的标题（Title）和文本（Text），后者本身就是富文本，直接显示就行了。
（2）News/*
a. News.aspx
1: <%@ Page Language="C#" MasterPageFile="~/Views/Shared/Site.Master" Inherits="ViewPage
" %>
2: <%@ Import Namespace="MvcTest.Views.News"%>
3: <asp:Content ID="Content1" ContentPlaceHolderID="MainContentPlaceHolder" runat="server">
4: <h1><%= Model.News.Title %> h1>
5: <%= Model.News.Text%>
6: <div class="comments">
7: <% foreach (MvcTest.Models.CommentItem comment in Model.Comments){ %>
8: <div>
9: <h3><%= comment.Title %> h3>
10: <%= comment.Text %>
11: div>
12: <%} %>
13: div>
14: <hr />
15: <%= N2.Web.Link.To(Model.Back).Text("Back").Class("back") %>
16: <%= Html.ActionLink("Comment", "Comment", new { @class = "comment" }) %>
17: asp:Content>
（换了个插入代码的插件，原来用的也挺好，不过对<% %>支持不好，现在好了。）
这里用到了NewViewData类，定义如下：
1: public class NewsViewData
2: {
3: public ContentItem Back { get; set; }
4: public NewsPage News { get; set; }
5: public IEnumerable
Comments { get; set; }
6: }
控制器负责创建NewsViewData而不是NewsPage的实例并传递给视图。
视图模板中的第15行显示后退到新闻列表页面的链接，第16行则产生到添加评论表单的链接，写法不同。
b. Comment.aspx
1: <%@ Page Title="" Language="C#" MasterPageFile="~/Views/Shared/Site.Master" Inherits="ViewPage
" %>
2: <%@ Import Namespace="MvcTest.Models"%>
3: <%@ Import Namespace="MvcTest.Controllers"%>
4: <asp:Content ID="Content1" ContentPlaceHolderID="MainContentPlaceHolder" runat="server">
5: <% Html.BeginForm("Submit", "News"); %>
6: <h1><%= string.Format("Add comment to '{0}'", Model.Title) %>
h1>
7: <p>
8: <label>Subject label>
9: <%= Html.TextBox("title") %>
10: p>
11: <p>
12: <label>Comment label>
13: <%= Html.TextArea("text", "") %>
14: p>
15: <p>
16: <input type="submit" />
17: <%= Html.ActionLink("Back", "index") %>
18: p>
19: <% Html.EndForm(); %>
20: asp:Content>
这个表单会提交给NewsController的Submit这个Action，最终被存储到数据库中。
（3）NewsContainer/Index.aspx
1: <%@ Page Language="C#" MasterPageFile="~/Views/Shared/Site.Master" Inherits="ViewPage
" %>
2: <%@ Import Namespace="MvcTest.Views.NewsContainer"%>
3: <asp:Content ID="Content1" ContentPlaceHolderID="MainContentPlaceHolder" runat="server">
4: <h1><%= Model.Container.Title %> h1>
5: <ul class="newsList">
6: <% foreach (MvcTest.Models.NewsPage item in Model.News) { %>
7: <li><%= N2.Web.Link.To(item) %> li>
8: <% } %>
9: ul>
10: asp:Content>
新闻容器页面，显示新闻项列表。这里也用到了视图数据类，NewsContainerViewData：
1: public class NewsContainerViewData
2: {
3: public Models.NewsContainer Container { get; set; }
4: public IEnumerable
News { get; set; }
5: }
不必多说，继续。
（4）TextPart/Index.ascx
1: <%@ Control Language="C#" Inherits="System.Web.Mvc.ViewUserControl" %>
2: <%= Html.DisplayContent("Text") %>
它可以嵌入到母版页中左边栏上定义的Zone内。