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>

<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>

（换了个插入代码的插件，原来用的也挺好，不过对支持不好，现在好了。）

这里用到了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:  }

<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>

控制器负责创建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>

不必多说，继续。<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") %>

<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>

它可以嵌入到母版页中左边栏上定义的Zone内。