Form element (List)
Applies to: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013
Describes the forms in a base list type.
<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>
Elements and attributes
The following sections describe attributes, child elements, and parent elements.
||Optional Text. Specifies whether the form is the default form to use for the specified Type.
For example, one can define multiple forms for which Type equals DisplayForm. If this is the case, a default display form must be established so that a list can determine which display form to use.
If multiple forms are defined that have the same Type, and a default form is not established by specifying Default="TRUE", a default form will be chosen programmatically.
If there is only one form that is defined for a specified Type, Default="TRUE" is enforced programmatically.
||Optional Text. Specifies the file system path, including the leaf name, of the file containing the template used for the list of document libraries that is rendered in a file dialog box. The value of this attribute is relative to the
||Optional Text. Specifies the relative path to the folder in the setup directory that contains the .aspx page of the form, for example,
||Optional Text. Specifies the list template to which the form belongs.
||Required Text. Indicates the type of form being described and can be one of the following values: DisplayForm, EditForm, or NewForm.
||Required URL. Specifies the path to the ASP.NET file used for the form.
||Optional Text. Specifies whether a ListFormWebPart should be created when the form is provisioned. By default, a ListFormWebPart object is created unless this attribute is set to FALSE. If this attribute equals FALSE, use the WebParts child element to define your customized list form web part.
||Optional Boolean. Used during upgrade to specify that Microsoft SharePoint Foundation use Collaborative Application Markup Language (CAML), as in previous versions of the technology, instead of Web controls, to define the view of an item within a form.
||Optional Text. Specifies the zone for the web part.
- Minimum: 0
- Maximum: Unbounded
The following example shows the form definitions that are specified in the Schema.xml file for Announcements lists.
<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>