ページのアップグレード
最終更新日: 2010年4月6日
適用対象: SharePoint Foundation 2010
一般的なページのアップグレード
Microsoft SharePoint Foundation 2010 は、そのページがカスタマイズされているかどうかに応じて、ページのアップグレードに異なる戦略を使用します。
SharePoint Foundation は、Web サイトが作成されたサイト定義のバージョンを追跡しています。カスタマイズされていないフロントエンド サイト定義を変換する更新定義が Web サイトにある場合、その Web サイトはアップグレードできます。アップグレード プロセスの後は、カスタマイズされていないフロントエンド ファイルへの参照はすべて前のディレクトリから現在のディレクトリにマッピングされます。
%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\
最初のアップグレードのときに、すべての Web サイト パスがアップグレードされるわけではありません。アップグレード パスを持たない既存のサイト定義は、アップグレード後も機能はしますが、元のページを指したままです。また、データベースに格納されている前のバージョンのカスタマイズされたページが、更新された Web サイトにまだ残っている可能性もあります。
SharePoint Foundation は、コードの解析とページのレンダリングを行うときに、そのページがどの Web サイトに関連付けられているかを調べて、フロントエンド Web サーバー上のカスタマイズされていないファイルのバージョンを判断します。前のバージョンのページが、現在のバージョンの標準と必ずしも互換性があるとは限りません。これらのページは、まだサイトがアップグレードされていない場合は互換モードで実行されますが、アップグレード定義が適用されてサイトがアップグレードされた後は、SharePoint Foundation は、ページが Microsoft ASP.NET 3.5 と完全に互換性があると見なすようになります。つまり、たとえば、Web パーツ ゾーンを含むページは Web パーツ マネージャーを持つと見なされ、各ページが有効なコントロール識別子 (ID) を持ち、マスター ページと関連付けられているものと見なされます。
ページの互換性
前のバージョンの SharePoint Foundation では、データベース内のカスタマイズされたページは、"Windows SharePoint Services" パーサーを使用して解析されます。このパーサーは、ASP.NET パーサーとは許容範囲が異なります。ページに無効な形式のマークアップ言語が含まれている場合、そのページは前のバージョンではうまく機能する場合がありますが、パーサーの違いが原因で、ASP.NET や現在のバージョンの SharePoint Foundation ではうまく機能しない可能性があります。
SharePoint Foundation パーサーでは、ページのマークアップ内の既知のブレーキング問題の一部が対処されています。対処されている問題には、以下のものがあります。
ASP.NET と互換性のない無効なコントロール ID。ID が数字またはサポートされていない文字で始まるため名前が無効な場合や、ID が空の文字列の場合、ID がページ上の他の ID との兼ね合いで一意ではない場合などが該当します。この変更で、クライアント側のスクリプトが以前の ID 名に依存している場合にページが壊れる可能性があります。
SharePoint Foundation によりページに挿入された既知の属性 (たとえば、__Preview、__Error、__Web PartId、WebPart) は、Web パーツに SharePoint IAttributeAccessor インターフェイスを実装することにより処理されます。
Trace 属性の削除。
<WebPart:WebPartZone>、<SharePoint:Theme> などのタグを登録するための適切なディレクティブの追加。
SharePoint Foundation は、ページ上の以下のブレーキング問題は修正しようとしません。
コントロールの不明属性。
<object runat=server> タグの存在。
属性内にあるデータ バインド式 (<% ... %>)。
SharePoint Foundation は、カスタマイズされた各ページのバージョンの整数値をデータベースに格納します。カスタマイズされているページが参照されると、SharePoint はページのバージョン番号をチェックします。バージョン番号がアップグレードされていない前のバージョンに対応する場合、SharePoint は、自動的にこれらのさまざまなブレーキング問題を修正し、ページを更新します。
アプリケーション ページ
SharePoint Foundation は、言語に依存しないフォルダーにレイアウト ファイルを格納し、ユーザーを前の /_layouts 場所から現在の場所に移動させるリダイレクトを自動的にセットアップします。
レイアウト ページは、通常、SPWeb.MasterUrl プロパティで設定されたマスター ページを使用するように調整されています。前のバージョンのサイト定義の場合、このプロパティは、前のバージョンの外観を保つマスター ページを参照するようになっている必要があります。
Web パーツ
前のバージョンの SharePoint Foundation の Web パーツは、現在のバージョンでも機能し続けますが、構成に若干変更を加えなければならない場合があります。SharePoint Foundation インストールをホストするために新しい Web アプリケーションを作成する場合は、そのインストール用の web.config ファイルを更新して、安全なコントロールとコード アクセス セキュリティ (CAS) の追加のポリシー設定を含める必要があります。
CAS の制限事項の基本レベルは SharePoint Foundation と同じですが、ポリシー ファイルは、ASP.NET 用の最新になるように修正されています。このため、前のリリースの CAS ポリシー ファイルは、現在のバージョンの SharePoint Foundation で再利用できない可能性があります。最もよい方法は、現在のバージョンの wss_minimaltrust.config ファイルをコピーし、必要に応じて権限を追加していくことです。
Web パーツをアップグレードする方法の詳細については、「Web パーツをアップグレードする」を参照してください。