通过

View 元素（网站）

  • 项目

上次修改时间： 2015年3月9日

适用范围： SharePoint Foundation 2010

本文内容
属性
子元素
父元素
出现次数

在网站定义内用于指定模块中页的列表视图。

<View
  AggregateView = "TRUE" | "FALSE"
  BaseViewID = "Integer"
  DefaultView = "TRUE" | "FALSE"
  DisplayName = "Text"
  FailIfEmpty = "TRUE" | "FALSE"
  FileDialog = "TRUE" | "FALSE"
  FPModified = "TRUE" | "FALSE"
  FreeForm = "TRUE" | "FALSE"
  Hidden = "TRUE" | "FALSE"
  List = "Integer" } "Text"
  Name = "Text"
  OrderedView = "TRUE" | "FALSE"
  PageType = "Text"
  Path = "Text"
  ReadOnly = "TRUE" | "FALSE"
  RecurrenceRowset = "TRUE" | "FALSE"
  RowLimit = "Integer"
  Scope = "Text"
  ShowHeaderUI = "TRUE" | "FALSE"
  Threaded = "TRUE" | "FALSE"
  Type = "HTML" | "Chart" | "Pivot"
  Url = "URL"
  WebPartOrder = "Integer"
  WebPartZoneID = "Text">
</View>

属性

属性

说明

AggregateView

可选属性，类型为 Boolean。若要将视图指定为 XML 表单库中使用的"合并表单"视图，则为 TRUE。默认情况下，XML 表单库是与最初隐藏的"合并表单"视图一起设置的。当使用 XML 编辑器将 XML 表单属性 (XFP) 文件连同该编辑器使用的模板一起发布到库的 Forms 目录时，AggregateView 属性会标识"合并表单"视图，可以显示或隐藏该视图，具体取决于库的列表模板或定义是否支持数据合并。

BaseViewID

可选属性，类型为 Integer。指定基视图的 ID。

DefaultView

可选属性，类型为 Boolean。若要指定该视图为默认视图，则为 TRUE。

DisplayName

可选属性，类型为 Text。指定在"快速启动"栏上显示的视图名称。

FailIfEmpty

可选属性，类型为 Boolean。在视图未返回任何项的情况下，若要返回一个空白页或 HTTP 错误代码，而不是呈现 ViewEmpty 元素，则为 TRUE。用于对客户端应用程序的视图进行编程操作，从而使客户端应用程序无需分析文档来确定视图是否为空。

FileDialog

可选属性，类型为 Boolean。若要指定在 Microsoft SharePoint Foundation 的上下文中使用的应用程序（用于分析输出 HTML 以确定列表的内容）的文件对话框中显示视图，则为 TRUE。

FPModified

可选属性，类型为 Boolean。如果通过在网页编辑器中对视图进行编辑已将其更改，并且 SharePoint Foundation 用户界面 (UI) 不再可自定义该视图，则为 TRUE。

FreeForm

可选属性，类型为 Boolean。若要指定用于呈现某些字段类型的替代字段格式，则为 TRUE。具体而言，这将影响对自定义非表格格式视图类型特别有用的数字列对齐方式。

Hidden

可选属性，类型为 Boolean。若要隐藏视图，则为 TRUE。

List

可选属性，类型为 Integer 或 Text。指定列表的类型。此值可以是列表模板的 ID（一个整数），也可以是网站中设置的列表的 URL（一个字符串）。最好使用 Text，因为 Integer 可能不够明确（例如，网站中有两个通知列表而您指定了 List=104）。

Name

可选属性，类型为 Text。为视图指定的名称（用于选择用户界面中具有不同名称的视图，以及在为 Lookup 字段指定筛选器时引用指定视图）。

OrderedView

可选属性，类型为 Boolean。若要指定对视图进行排序，则为 TRUE。

PageType

可选属性，类型为 Text。指定在其中使用视图的表单的类型。可能的值包括：

  • DEFAULTVIEW   默认视图。

  • DIALOGVIEW   文件对话框视图。

  • DISPLAYFORM   列表项的显示表单。

  • DISPLAYFORMDIALOG   文件对话框的显示表单。

  • EDITFORM   列表项的编辑表单。

  • EDITFORMDIALOG   文件对话框的编辑表单。

  • INVALID   未使用。

  • MAXITEMS   未使用。

  • NEWFORM   列表项的新建表单。

  • NEWFORMDIALOG   文件对话框的新建表单。

  • NORMALVIEW   普通视图。

  • SOLUTIONFORM   解决方案表单。

  • VIEW   视图，其中包括默认视图和普通视图。

Path

可选属性，类型为 Text。指定视图的文件名。

ReadOnly

可选属性，类型为 Boolean。若要使视图为只读，则为 TRUE。

RecurrenceRowset

可选属性，类型为 Boolean。若要扩展视图中的定期事件并显示每个定期事件的每个实例，则为 TRUE。默认值为 FALSE。

RowLimit

可选属性，类型为 Integer。仅适用于 HTML 视图类型。指定可在任一页上呈现的最大行数。当超出行限制时，页上的 Next 和 Previous 按钮允许查看返回的记录集的其他部分。

如果未指定 RowLimit，则返回行数的默认值为 50。如果指定的视图类型为"无"，则在一个视图中返回记录集的所有行。

当呈现一个视图时，呈现变量 ViewHasNext 和 ViewHasPrev 将设置为 TRUE 或 FALSE，具体取决于当前视图是否已达到数据集的行限制。可以在连续的页面定义中使用这些变量，以便在页面上呈现 Next 和 Previous 按钮，如以下示例所示：

<Switch>
  <Expr><GetVar Name="ViewHasPrev"/></Expr>
  <Case Value="TRUE">
    <![CDATA[...Previous button defined here... ]]>
  </Case>
</Switch>

在当前显示中存在向前或向后的分页内容时，也将变量 NextPageURL 和 PrevPageURL 设置为非空值。通过构造 Next 和 Previous 按钮，可以使用这些变量以便具有用于访问下一页内容的正确的 URL。

Scope

可选属性，类型为 Text。指定文档库的视图的递归范围。可能的值包括：

  • FilesOnly — 仅显示特定文件夹的文件。

  • Recursive — 显示所有文件夹的所有文件。

  • RecursiveAll — 显示所有文件夹的所有文件和所有子文件夹。

若未设置此属性，则视图将仅显示特定文件夹的文件和子文件夹。此属性的值与 SPView 类的 Scope 属性相对应。

ShowHeaderUI

可选属性，类型为 Boolean。若要呈现在标题显示模式中使用的所有 FieldRef 元素，而不使用 HTML 来修饰用户界面，则为 FALSE。换句话说，当设置此模式时，用户界面不能按照列标题中的超链接进行排序和筛选。默认值为 TRUE。

Threaded

可选属性，类型为 Boolean。若要在视图中应用内部分组，则为 TRUE。线程视图是基于内置线程列（假定列表中存在该列）构建的。作为辅助排序方式，将按照此字段对视图进行排序。如果已指定对视图中的其他列进行排序或分组，则在线程列排序顺序之前应用这些列。因此，可以将按照主题分组的所有讨论收集在一起，并可以在该集合下显示消息线程。

若为 TRUE，则当在以线索组织的讨论列表视图中使用 RowLimit 元素时，该元素具有不同的含义。它会指定要返回的讨论线程数（其中，一个线程可以包含一个或多个项），而不是指定要返回的项数。除了将 Threaded 属性设置为 TRUE 之外，还必须按照线程 ID 对线程视图进行排序，以便此行限制行为能够生效。

Type

可选属性，类型为 Text。指定视图的呈现类型。类型是常见的枚举 HTML 视图，并可将其设置为 HTML、Chart、Pivot、GANTT 或 CALENDAR。

Url

可选属性，类型为 URL。指定视图的 URL。

WebPartOrder

可选属性，类型为 Integer。指定 Web 部件在区域内的垂直位置。

WebPartZoneID

可选属性，类型为 Text。指定 Web 部件的区域。

子元素

元素

BinarySerializedWebPart

父元素

File

出现次数

最小值：0

最大值：无限制

备注

有关使用 View 元素的示例，请参阅 Module 元素（网站）。