N2CMS Mvc Examples 学习记录 (4) – 母版页和视图
看母版页和视图会看到很多呈现方面的细节，包括如何使用N2的一些工具类来生成导航菜单、站点路径，如何在页面中放一个Zone（用于容纳Parts），以及如何显示模型对象的数据。不过N2CMS的API文档不是很详细，甚至根本没有说明，有时候不容易想出来一些方法具体实现的什么功能。
1. 母版页（Site.Master）
（1）显示管理工具栏
1: n2:SlidingCurtain runat="server"><!--CRLF-->
2: n2:DragDropControlPanel runat="server" /><!--CRLF-->
3: n2:SlidingCurtain><!--CRLF-->
加上这段代码，管理员登录后可以在页面左看到管理面板工具栏。
（2）生成导航菜单
1: ul id="mainMenu"><!--CRLF-->
2: li>a href="">Homea>li><!--CRLF-->
3: <%= N2.Web.Tree.From(N2.Find.StartPage, 2).Filters(new N2.Collections.NavigationFilter()).ExcludeRoot(true)%><!--CRLF-->
4: li><%= Html.ActionLink("Static controller", "Items", "Static", new { id = "from the menu" }, null)%>li><!--CRLF-->
5: ul><!--CRLF-->
N2.Find.StartPage获取到起始页（即首页）的内容项。
N2.Web.Tree.From从指定内容项（这里是起始页）开始查找树结果，查找的深度为2层，并从中用导航过滤器找到所有的内容项，再排除根（即起始页，这个已经显示过了），最后以LI呈现出来。
（3）左边栏内容
1: div class="leftColumn"><!--CRLF-->
2: h2><%= N2.Utility.Evaluate(N2.Find.AtLevel(N2.Find.CurrentPage, N2.Find.StartPage, 2), "Title") %>h2><!--CRLF-->
3: ul><!--CRLF-->
4: <%= N2.Web.Tree.Between(N2.Find.CurrentPage, N2.Find.StartPage, true, 2).Filters(new N2.Collections.NavigationFilter()).ExcludeRoot(true) %><!--CRLF-->
5: ul><!--CRLF-->
6: <% Html.DroppableZone("Left").Render(); %><!--CRLF-->
7: div>--/leftColumn--><!--CRLF-->
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呈现。
最后的是在此处呈现一个名为"Left"的Zone，这里可以在管理界面中把TextPart放到这里。
（4）右边栏内容
1: div class="rightColumn"><!--CRLF-->
2: p><!--CRLF-->
3: <% foreach(N2.ContentItem item in N2.Find.EnumerateBetween(N2.Find.StartPage, N2.Find.CurrentPage, false)) { %><!--CRLF-->
4: <%= N2.Web.Link.To(item) %> /<!--CRLF-->
5: <% } %><!--CRLF-->
6: <%= N2.Utility.Evaluate(N2.Find.CurrentPage, "Title") %><!--CRLF-->
7: p><!--CRLF-->
8: asp:ContentPlaceHolder ID="MainContentPlaceHolder" runat="server"><!--CRLF-->
9: asp:ContentPlaceHolder><!--CRLF-->
10: div>--/rightColumn--><!--CRLF-->
N2.Find.EnumerateBetween(N2.Find.StartPage, N2.Find.CurrentPage, false)返回两个内容项之间的所有项的迭代（IEnumerable<contentitem>），false排除了最深层的页面，即当前页面。显示到这些项的链接。最后显示当前页的标题：。</contentitem>
下面的占位符把呈现工作交给各个视图模板来实现了。
2. 视图模板
（1）Content/Index.aspx
1: " %><!--CRLF-->
2: <!--CRLF-->
3: asp:Content ID="Content1" ContentPlaceHolderID="MainContentPlaceHolder" runat="server"><!--CRLF-->
4: h1> %= Model.Title % >h1><!--CRLF-->
5: %= Model.Text % ><!--CRLF-->
6: asp:Content><!--CRLF-->
显示ContentPage中的标题（Title）和文本（Text），后者本身就是富文本，直接显示就行了。
（2）News/*
a. News.aspx
1: " %>
2:
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<commentitem> Comments { get; set; }</commentitem>
6: }
控制器负责创建NewsViewData而不是NewsPage的实例并传递给视图。
视图模板中的第15行显示后退到新闻列表页面的链接，第16行则产生到添加评论表单的链接，写法不同。
b. Comment.aspx
1: " %>
2:
3:
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>Subjectlabel>
9: = Html.TextBox("title") %>
10: p>
11: p>
12: label>Commentlabel>
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: " %>
2:
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<newspage> News { get; set; }</newspage>
5: }
不必多说，继续。<style type="text/css"> .csharpcode, .csharpcode pre { font-size: small; color: black; font-family: consolas, "Courier New", courier, monospace; background-color: #ffffff; /*white-space: pre;*/ } .csharpcode pre { margin: 0em; } .csharpcode .rem { color: #008000; } .csharpcode .kwrd { color: #0000ff; } .csharpcode .str { color: #006080; } .csharpcode .op { color: #0000c0; } .csharpcode .preproc { color: #cc6633; } .csharpcode .asp { background-color: #ffff00; } .csharpcode .html { color: #800000; } .csharpcode .attr { color: #ff0000; } .csharpcode .alt { background-color: #f4f4f4; width: 100%; margin: 0em; } .csharpcode .lnum { color: #606060; }</style>
（4）TextPart/Index.ascx
1:
2: = Html.DisplayContent("Text") %>
它可以嵌入到母版页中左边栏上定义的Zone内。