View 元素 (站点)
适用于： SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013
在网站定义内用于指定模块中页的列表视图。
<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>
元素和属性
下面各部分介绍了属性、子元素和父元素。
Attributes
| 属性 | 说明 |
|---|---|
| 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。 如果为 TRUE ，则指定在 Microsoft SharePoint Foundation 上下文中使用的应用程序的文件对话框中显示视图，后者分析输出 HTML 以确定列表的内容。 |
| FPModified |
可选属性，类型为 Boolean。 如果视图已通过在网页编辑器中的编辑进行了更改，并且该视图不再可由 SharePoint Foundation 用户界面 (UI) 进行自定义，则为 TRUE。 |
| 自由 |
可选属性，类型为 Boolean。 若要指定用于呈现某些字段类型的替代字段格式，则为 TRUE。 具体而言，这将影响对自定义非表格格式视图类型特别有用的数字列对齐方式。 |
| Hidden |
可选属性，类型为 Boolean。 若要隐藏视图，则为 TRUE。 |
| 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 视图类型。 指定可在任一页上呈现的最大行数。 当超出行限制时，页上的 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 。 |
| 螺纹 |
可选属性，类型为 Boolean。 若要在视图中应用内部分组，则为 TRUE。 线程视图是基于内置线程列（假定列表中存在该列）构建的。 作为辅助排序方式，将按照此字段对视图进行排序。 如果已指定对视图中的其他列进行排序或分组，则在线程列排序顺序之前应用这些列。 因此，可以将按照主题分组的所有讨论收集在一起，并可以在该集合下显示消息线程。 若选择 TRUE，则当在以线索组织的讨论列表视图中使用 RowLimit 元素时，该元素具有不同的含义。 它会指定要返回的讨论线程数（其中，一个线程可以包含一个或多个项），而不是指定要返回的项数。 除了将 Threaded 属性设置为 TRUE 之外，还必须按照线程 ID 对线程视图进行排序，以便此行限制行为能够生效。 |
| 类型 |
可选属性，类型为 Text。 指定视图的呈现类型。 类型是常见的枚举 HTML 视图，并可将其设置为 HTML、Chart、Pivot、GANTT 或 CALENDAR。 |
| Url |
可选属性，类型为 URL。 指定视图的 URL。 |
| WebPartOrder |
可选属性，类型为 Integer。 指定 Web 部件在区域中的垂直定位。 |
| WebPartZoneID |
可选 文本。 指定 Web 部件的区域。 |
子元素
父元素
出现次数
- 最小值：0
- 最大值：无限制
备注
有关使用 View 元素的示例，请参阅 Module 元素 (Site) 。