研究一下模型类,总共有6个类,它们都表示所包含的内容。
1. AbstractPage
1: [WithEditableTitle, WithEditableName]
2: public abstract class AbstractPage : ContentItem, INode
3: {
4: public string PreviewUrl
5: {
6: get { return Url; }
7: }
8: }
这个抽象类代表所有将以页面显示的内容项。WithEditableTitle特性让此类的Title属性可被编辑,WithEditableName让此类的Name属性可被编辑。定义的只读属性PreviewUrl,直接返回Url值,似乎没有什么用。
2. ContentPage
1: [Definition("Content Page", Installer = N2.Installation.InstallerHint.PreferredStartPage)]
2: public class ContentPage : AbstractPage
3: {
4: [EditableFreeTextArea("Text", 100)]
5: public virtual string Text
6: {
7: get { return (string)(GetDetail("Text") ?? string.Empty); }
8: set { SetDetail("Text", value, string.Empty); }
9: }
10: }
这个类表示有文字内容的内容项,也就是它拥有内容了,这是通过虚拟的Text属性来进行获取和设置的。Definition特性用于为ContentPage指定一些特殊的设置,第一个参数是它的标题(显示在N2管理界面中,当新建和编辑页面的时候可以看到),第二个是设置属性Installer,它让N2在安装此网站时能让ContentPage也作为起始页进行选择(在安装的第2步可以看到)。最好不要用这个特性,而是用更准确的PageDefinition代替。ContentPage类定义的Text属性上的EditableFreeTextArea特性是表示Text属性将可以被N2用一个富文本编辑器编辑,get和set方法其实可以写的更省一些。
3. NewsPage
1: [Definition("News")]
2: [RestrictParents(typeof(NewsContainer))]
3: public class NewsPage : AbstractPage
4: {
5: public NewsPage()
6: {
7: Visible = false;
8: }
9:
10: [EditableFreeTextArea("Text", 100)]
11: public virtual string Text
12: {
13: get { return (string)(GetDetail("Text") ?? string.Empty); }
14: set { SetDetail("Text", value, string.Empty); }
15: }
16:
17: public virtual IEnumerable GetComments()
18: {
19: foreach (ContentItem item in GetChildren())
20: {
21: if (item is CommentItem)
22: {
23: yield return item as CommentItem;
24: }
25: }
26: }
27: }
NewsPage表示新闻内容,而且它通过RestrictParents限制其父结点只能是NewsContainer类。它的构造函数中把Visible属性设置为false,查看文档知道这可以让新闻页面不显示在站点地图中,当然也可以让它不显示在导航中。另外新闻可以有评论,所以GetComments方法返回所有评论,这也说明NewsPage是评论的父结点。
4. NewsContainer
1: [Definition("News Collection")]
2: public class NewsContainer : AbstractPage
3: {
4: public virtual IEnumerable GetNews()
5: {
6: return GetChildren(new AccessFilter(), new TypeFilter(typeof (NewsPage))).Cast();
7: }
8: }
新闻容器类,它的作用就是列出所有的新闻,这个工作由GetNews方法来实现。
5. CommentItem
1: [Definition("Comment")]
2: [RestrictParents(typeof(NewsPage))]
3: public class CommentItem : AbstractPage
4: {
5: public override bool IsPage
6: {
7: get { return false; }
8: }
9:
10: public override string IconUrl
11: {
12: get { return "~/Content/comment.png"; }
13: }
14:
15: [EditableFreeTextArea("Text", 100)]
16: public virtual string Text
17: {
18: get { return (string)(GetDetail("Text") ?? string.Empty); }
19: set { SetDetail("Text", value, string.Empty); }
20: }
21: }
表示新闻的评论,所以有RestrictParents特性进行约束。另外有趣的是因为它不应该显示到单独的页面中,所以重写了IsPage属性,让其总是返回false。其他的属性就不用解释了。
6. TextPart
1: [PartDefinition("TextPart")]
2: public class TextPart : ContentItem
3: {
4: [EditableFreeTextArea("Text", 100)]
5: public virtual string Text
6: {
7: get { return (string)(GetDetail("Text") ?? string.Empty); }
8: set { SetDetail("Text", value, string.Empty); }
9: }
10: }
这个类不是从抽象的AbstractPage派生的,而是直接派生自ContentItem类,而且使用了PartDefinition特性进行修饰,这种模型对象通常会通过ASCX模板进行呈现,而不是页面模板(ASPX),说明它应该显示在页面中的某个部位,类似于WebForm中的用户控件,这样可以在不同的页面中重用。具体使用还没有研究过。