Form 元素 (List)

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

介绍基列表类型中的表单。

<Form  Default = "TRUE" | "FALSE"  MobileUrl = "Text"
  Path = "Text"
  SetupPath = "Text"
  Template = "Text"
  Type = "DisplayForm" | "EditForm" | "NewForm"
  Url = "URL"  UseDefaultListFormWebPart = "TRUE" | "FALSE"
  UseLegacyForm = "TRUE" | "FALSE"
  WebPartZoneID = "Text">  <WebParts>    <AllUsersWebPart      WebPartOrder = Integer      WebPartZoneID = "Text">        <![CDATA[...]]>    </AllUsersWebPart>  </WebParts>
</Form>

元素和属性

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

Attributes

属性	说明
默认	可选 文本。 指定表单是否为用于指定 Type 的默认表单。 例如，用户可以定义多个其 Type 为 DisplayForm 的表单。 如果是这种情况，则必须建立默认显示窗体，以便列表可以确定要使用的显示窗体。 如果定义了多个具有相同 Type 的窗体，并且未通过指定 Default=“TRUE”来建立默认窗体，则将以编程方式选择默认窗体。 如果只有一个为指定的类型定义的窗体，则以编程方式强制实施 Default=“TRUE”。
MobileUrl	可选 文本。
路径	可选属性，类型为 Text。 指定文件的文件系统路径（包括叶名称），该文件包含用于呈现在文件对话框中的文档库列表的模板。 此属性的值相对于 _layouts 目录，并且不以正斜杠 (/) 开头。
SetupPath	可选 文本。 指定安装目录中包含窗体的 .aspx 页的文件夹的相对路径， pages/form.aspx例如 。
模板	可选属性，类型为 Text。 指定表单所属的列表模板。
类型	必需 文本。 指示要描述的表单类型，可为以下值之一：DisplayForm、EditForm 或 NewForm。
Url	必需属性，类型为 URL。 指定用于表单的 ASP.NET 文件的路径。
UseDefaultListFormWebPart	可选属性，类型为 Text。 指定是否应在设置表单时创建 ListFormWebPart。 默认情况下，除非此属性设置为 FALSE，否则将创建 ListFormWebPart 对象。 如果此属性等于 FALSE，请使用 WebParts 子元素定义自定义列表表单 Web 部件。
UseLegacyForm	可选属性，类型为 Boolean。 在升级期间用于指定 Microsoft SharePoint Foundation 使用协作应用程序标记语言 (CAML) ，如以前版本的技术（而不是 Web 控件）来定义窗体中项的视图。
WebPartZoneID	可选 文本。 指定 Web 部件的区域。

子元素

• ListFormBody
• ListFormButtons
• ListFormClosing
• ListFormOpening
• WebParts

父元素

• Forms

出现次数

• 最小值：0
• 最大值：无限制

示例

下面的示例演示在通知列表的 Schema.xml 文件中指定的表单定义。

<Forms>
      <Form Type="DisplayForm" Url="DispForm.aspx" SetupPath="pages\form.aspx" WebPartZoneID="Main" />
      <Form Type="EditForm" Url="EditForm.aspx" SetupPath="pages\form.aspx" WebPartZoneID="Main" />
      <Form Type="NewForm" Url="NewForm.aspx" SetupPath="pages\form.aspx" WebPartZoneID="Main" />
    </Forms>