File 要素 (アップグレード)

適用対象: SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013

既存のプロビジョニング済みファイルと、Microsoft SharePoint Foundation 2010にアップグレードするための同等のファイルとの関係について説明します。以前のバージョンのファイルのセットアップ パスが、%ProgramFiles%\Common Files\Microsoft Shared\Web サーバー拡張機能\15\TEMPLATE ディレクトリに対する新しいバージョンのセットアップ パスにどのようにマップされるかを指定します。

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

要素と属性

以下のセクションで、属性、子要素、親要素について説明します。

属性

属性	説明
FromPath	文字列 が必要です。 %ProgramFiles%\Common Files\Microsoft Shared\Web サーバー拡張機能\15\TEMPLATE ディレクトリに対してアップグレードするファイルのセットアップ パスを指定します。 トークン {LocaleId} を使用して、パスの一部としてロケール識別子を指定します。 例: FromPath="{LocaleId}\STS\Lists\announce\EditForm.aspx"
ToPath	文字列 が必要です。 %ProgramFiles%\Common Files\Microsoft Shared\web サーバー拡張機能\15\TEMPLATE ディレクトリを基準として、古いバージョンのファイルがマップされるファイルのセットアップ ディレクトリ内の場所を指定します。 例: ToPath= "Features\AnnouncementsList\announce\EditForm.aspx"

子要素

None

親要素

• ファイル

Occurrences

• 最小 : 0
• 最大: 制約なし

注釈

ファイルのアップグレードは、任意の種類のカスタマイズされていないファイル (通常は .aspx ページ) に適用できますが、ドキュメント テンプレートなどのエンティティにも適用できます。 アップグレード定義では、リストの一部としてプロビジョニングされたものや、Web パーツ用の .dwp ファイルなど、最上位の Web サイトにのみ配置されたファイルを含む、以前にインストールされたすべてのカスタマイズされていない ("ゴースト化された" ファイル) を一覧表示することをお勧めします。

SharePoint Foundation では {LocaleId} トークンがサポートされています。これは、パスの一部として含めるロケール識別子を指定します。 これにより、ロケール固有のファイルをマップできます。

例

この要素の使用方法の例については、「 アップグレード定義スキーマ」を参照してください。