ListInstance Element (List Instance)

Applies to: SharePoint Foundation 2010

Specifies default data with which to provision the given list type.

<ListInstance 
  CustomSchema = string
  Description = "Text"
  DocumentTemplate = integer
  FeatureId = "Text"
  Hidden = "TRUE" | "FALSE"
  HyperlinkBaseUrl = string
  Id = Text
  OnQuickLaunch = "TRUE" | "FALSE"
  QuickLaunchUrl = "Text"
  RootWebOnly = "TRUE" | "FALSE"
  TemplateType = Integer
  Title = "Text"
  Url = "Text"
  VersioningEnabled = "TRUE" | "FALSE"
</ListInstance>

Attributes

Attribute	Description
CustomSchema	Optional string. Specifies the custom schema to use for the list instance.
Description	Optional Text. Contains a description of the list.
DocumentTemplate	Optional string. Specifies the document template to use for the list instance.
FeatureId	Required Text. Specifies the GUID of the Feature. If you do not specify a Feature GUID, Microsoft SharePoint Foundation uses the ID of the default Feature, in other words, the one containing the ListInstance element. If the list template for the list instance is contained within a different Feature, you must specify the ID of that Feature through the FeatureId attribute.
Hidden	Optional Boolean. Specifies if the list is hidden.
HyperlinkBaseUrl	Optional string. Specifies the absolute URL used for hyperlinks in the list.
Id	Optional Text. Specifies a unique identifier for the list instance. The integer must be unique across the Feature definition.
OnQuickLaunch	Optional Boolean. TRUE to display lists created from the list definition on the Quick Launch bar.
QuickLaunchUrl	Optional Text. Specifies the URL of the view page to open for the list through Quick Launch navigation.
RootWebOnly	Optional Boolean. TRUE to specify that the list created from the definition exists only in the root Web site of a site collection.
TemplateType	Required Integer. Returns the integer identifier of the list template to use.
Title	Required Text. Title of the list in the schema. This must also be unique.
Url	Required Text. Returns the site-relative URL at which to place the list.
VersioningEnabled	Optional Boolean. Specifies if versioning is enabled on the list.

Child Elements

Data, DataSource Element (List Instance)

Parent Elements

Elements

Occurrences

Minimum: 0 Maximum: Unbounded

Remarks

The ListInstance Feature element maps to the List element as used in SharePoint Foundation within the Configuration element in Onet.xml.

Example

For an example of how this element is used, see List Instances.