通过

View 元素（模块）

  • 项目

适用于：SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013

描述网站定义的模块中的视图。

定义

<View
  AggregateView = "TRUE" | "FALSE"
  BaseViewID = "Integer"
  ContentTypeId = string
  DefaultView = "TRUE" | "FALSE"
  DisplayName = "Text"
  FailIfEmpty = "TRUE" | "FALSE"
  FileDialog = "TRUE" | "FALSE"
  FPModified = "TRUE" | "FALSE"
  FreeForm = "TRUE" | "FALSE"
  Hidden = "TRUE" | "FALSE"
  ID = string
  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 = string>
</View>

元素和属性

下面各部分介绍了属性、子元素和父元素。

Attributes

属性 说明
AggregateView 可选属性，类型为 Boolean。 若要将视图指定为 XML 表单库中使用的“合并表单”视图，则为 TRUE。 默认情况下，XML 表单库是与最初隐藏的“合并表单”视图一起设置的。 当使用 XML 编辑器将 XML 表单属性 (XFP) 文件连同该编辑器使用的模板一起发布到库的 Forms 目录时，AggregateView 属性会标识“合并表单”视图，可以显示或隐藏该视图，具体取决于库的列表模板或定义是否支持数据合并。
BaseViewID 可选属性，类型为 Integer。 指定基视图的 ID。
ContentTypeId 可选属性，类型为 string。 指定内容类型的 ID。
DefaultView 可选属性，类型为 Boolean。 若要指定该视图为默认视图，则为 TRUE。
DisplayName 可选属性，类型为 Text。 指定“快速启动”上显示的视图的名称。
FailIfEmpty 可选属性，类型为 Boolean。 在视图未返回任何项的情况下，若要返回一个空白页或 HTTP 错误代码，而不是呈现 ViewEmpty 元素，则为 TRUE。 用于对客户端应用程序的视图进行编程操作，从而使客户端应用程序无需分析文档来确定视图是否为空。
FileDialog 可选属性，类型为 Boolean。 若要指定在 Windows SharePoint Services 的上下文中使用的应用程序（用于分析输出 HTML 以确定列表的内容）的文件对话框中显示视图，则为 TRUE。
FPModified 可选属性，类型为 Boolean。 如果视图已通过在网页编辑器中的编辑进行了更改，并且视图不再可由Microsoft Windows SharePoint Services UI 自定义，则为 TRUE。
自由 可选属性，类型为 Boolean。 若要在字段呈现中指定某些字段类型的替代字段格式，则为 TRUE。 具体而言，这将影响对自定义非表格格式视图类型特别有用的数字列对齐方式。
Hidden 可选属性，类型为 Boolean。 若要隐藏视图，则为 TRUE。
ID 可选属性，类型为 string。 指定视图的 ID。
List 可选属性，类型为 Integer 或 Text。 指定列表的类型。 此值可以是列表模板的 ID（一个整数），也可以是网站中设置的列表的 URL（一个字符串）。 最好使用 Text，因为 Integer 可能不够明确（例如，网站中有两个通知列表而您指定了 List=104）。
名称 可选 文本。 为视图指定的名称（用于选择用户界面中具有不同名称的视图，以及在为 Lookup 字段指定筛选器时引用指定视图）。
OrderedView 可选属性，类型为 Boolean。 若要指定对视图进行排序，则为 TRUE。
PageType 可选属性，类型为 Text。 指定在其中使用视图的表单的类型。 可能的值包括以下：

* DEFAULTVIEW 默认视图。
* DIALOGVIEW “文件”对话框视图。
* DISPLAYFORM 列表项的显示窗体。
* DISPLAYFORMDIALOG 文件对话框的显示窗体。
* EDITFORM 编辑列表项的窗体。
* EDITFORMDIALOG “编辑文件”对话框的窗体。
* 无效 未使用。
* MAXITEMS 未使用。
* NEWFORM 列表项的新窗体。
* NEWFORMDIALOG 文件对话框的新窗体。
* NORMALVIEW 普通视图。
* SOLUTIONFORM 解决方案窗体。
* 视图 视图，包括默认视图和普通视图。
路径 可选属性，类型为 Text。 指定视图的文件名。
ReadOnly 可选属性，类型为 Boolean。 若要使视图为只读，则为 TRUE。
RecurrenceRowset 可选属性，类型为 Boolean。 若要扩展视图中的定期事件并显示每个定期事件的每个实例，则为 TRUE。 默认值为 FALSE 。
RowLimit 可选属性，类型为 Integer。 仅适用于 HTML 视图类型。 指定可在任一页上呈现的最大行数。 超过行限制时，页面上的下一个和上一个按钮允许查看返回的记录集的其他部分。

如果未指定 RowLimit ，则返回的默认行数为 50。 如果为视图类型指定了“None”，则会在一个视图中返回记录集的所有行。

呈现视图时，呈现变量 ViewHasNext 和 ViewHasPrev 将设置为 TRUE 或 FALSE，具体取决于当前视图是否已达到数据集中的行限制。 这些变量可用于连续的页面定义中呈现页面上的“下一步”和“上一步”按钮，如以下 XML 示例所示：
</Switch><Expr><GetVar Name="ViewHasPrev"/></Expr>

<Case Value="TRUE"><Switch>


<![CDATA[...Previous button defined here... ]]>


</Case>当当前显示中存在向前或向后分页内容时，变量 NextPageURL 和 PrevPageURL 也设置为非空值。 这些变量可以通过构造“ 下一步 ”和“ 上一页 ”按钮来使用这些变量，以获取用于访问下一页内容的正确 URL。
Scope 可选属性，类型为 Text。 指定文档库的视图的递归范围。 可能的值包括以下值：

* FilesOnly - 仅显示特定文件夹的文件。
* 递归 - 显示所有文件夹的所有文件。
* RecursiveAll - 显示所有文件夹的所有文件和所有子文件夹。

如果未设置此属性，则视图仅显示特定文件夹的文件和子文件夹。 此属性的值对应于 SPView 类的 Scope 属性。
ShowHeaderUI 可选属性，类型为 Boolean。 若要呈现在标题显示模式中使用的所有 FieldRef 元素，而不使用 HTML 来修饰用户界面，则为 FALSE。 换句话说，当设置此模式时，用户界面不能按照列标题中的超链接进行排序和筛选。 默认值为 TRUE 。
螺纹 可选属性，类型为 Boolean。 若要在视图中应用内部分组，则为 TRUE。 线程视图是基于内置线程列（假定列表中存在该列）构建的。 作为辅助排序方式，将按照此字段对视图进行排序。 如果已指定对视图中的其他列进行排序或分组，则在线程列排序顺序之前应用这些列。 因此，可以一起收集按主题分组的所有讨论，并且可以在集合下方显示消息线程。

如果 为 TRUE， 则 RowLimit 元素在线程讨论板列表视图上使用时具有不同的含义。 它会指定要返回的讨论线程数（其中，一个线程可以包含一个或多个项），而不是指定要返回的项数。 除了将 Threaded 属性设置为 TRUE 之外，还必须按照线程 ID 对线程视图进行排序；否则，此行限制行为将不会生效。
类型 可选属性，类型为 Text。 指定视图的呈现类型。 该类型是常见的枚举 HTML 视图，并可设置为 HTML、Chart 或 Pivot。
Url 可选属性，类型为 URL。 指定视图的 URL。
WebPartOrder 可选 整数。 指定 Web 部件的顺序。
WebPartZoneID 可选属性，类型为 string。 指定 Web 部件的区域。

子元素

BinarySerializedWebPart 元素（模块）

父元素

文件

出现次数

最小值：0

最大值：无限制

示例

有关如何使用此元素的示例，请参阅Modules。

另请参阅