File element (Upgrade)

發行項
06/29/2022

Applies to: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Describes the relationship between an existing provisioned file to its equivalent file for upgrading to Microsoft SharePoint Foundation 2010, specifying how setup paths of files in the previous version map (relate) to setup paths in the new version relative to their %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE directories.

<File
  FromPath = "String"
  ToPath = "String">
</File>

Elements and attributes

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute	Description
FromPath	Required String. Specifies the setup path of the file to be upgraded relative to the %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE directory. Use the token {LocaleId} to specify a locale identifier as part of the path. Example: `FromPath="{LocaleId}\STS\Lists\announce\EditForm.aspx"`
ToPath	Required String. Specifies the location in the setup directory of the file to which the file of the old version is mapped relative to the %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE directory. Example: `ToPath= "Features\AnnouncementsList\announce\EditForm.aspx"`

Child elements

None

Parent elements

Files

Occurrences

Minimum: 0
Maximum: Unbounded

Remarks

File upgrades can be applied to any sort of uncustomized file, usually .aspx pages, but also to entities such as document templates. In the upgrade definition, it is best to list all previously installed uncustomized (also known as "ghosted") files, including ones that were provisioned as part of a list, or files located only in the top-level website, such as .dwp files for web parts.

SharePoint Foundation supports a {LocaleId} token, which specifies the locale identifier to be included as part of the path. This makes it possible to map locale-specific files.

Example

For an example of how this element is used, see Upgrade Definition schema.

Share via