web.config ファイルの設定変更

  • [アーティクル]

web.config ファイルでは、現在の SharePoint 製品とテクノロジの基盤である ASP.NET 環境のほとんどの設定を制御します。

実例

開発者は安全なコントロールとして Web パーツをグローバルに登録する必要があります。また、オプションで web.config ファイルにアプリケーション設定を追加して、このファイルが正しく動作するように設定できます。適切な設定を含む新しい web.config 変更ファイルを作成し、作成したファイルをサーバーにインストールします。

詳細な技術情報

web.config ファイルは、SharePoint 製品とテクノロジおよび ASP.NET で公開されているディレクトリに格納された XML ファイルです。各 web.config ファイルは構成設定の複数のグループから成り、これらの構成設定は ASP.NET の動作方法を制御します。

追加の web.config ファイルを使用して、サーバー上のすべての Web アプリケーションに web.config への変更をグローバルに適用することができます。これらのファイルをまとめてマージして、コンテンツ Web アプリケーションごとの web.config ファイルを作成します。以下は、追加の web.config ファイル である webconfig.pwa.xml のサンプルです。Microsoft Office Project Server 2007 に含まれています。

<actions>
   <add path="configuration/SharePoint/SafeControls" id="{376C9977-14E1-4107-B599-2B091D22D477}">
      <SafeControl Assembly="Microsoft.Office.Project.Server.PWA, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" Namespace="Microsoft.Office.Project.PWA.WebParts" TypeName="*" Safe="True"/>
   </add>
   <add path="configuration/system.web/siteMap/providers" id="{2A7351DE-86A5-4a42-8D0C-86D352B52E8E}">
      <add name="PWASiteMapProvider" description="Project Web Access provider for global navigation" type="Microsoft.Office.Project.PWA.PWASiteMapProvider, Microsoft.Office.Project.Server.PWA, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" mode="Quick Launch" securityTrimmingEnabled="true" initializeMetadata="true"/>
      </add>
   <add path="configuration/system.web/httpModules" id="{B3156549-9487-45f9-BC83-C584C07A3527}">
   <add name="PwaAuthentication" type="Microsoft.Office.Project.PWA.PwaAuthenticationModule, Microsoft.Office.Project.Server.PWA, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" />
   </add>
</actions>

追加の webconfig ファイルは次のパスに格納されます。

%COMMONPROGRAMFILES%\Microsoft Shared\Web server extensions\12\CONFIG

ソリューションを使用すると、ソリューションが展開されている場所がどこであっても、Web アプリケーションの web.config ファイルに安全なコントロール エントリの追加を行うことができます。これは、サポート チームの介入を最小限に抑えながら Web パーツの安全なコントロール エントリを登録する推奨される方法です。

サポートの詳細情報

web.config ファイルが変更されると、アプリケーション ドメインの再読み込みがトリガされることがあり、キャッシュの削除、セッション状態の喪失、処理の失敗、ダウンロード/アップロードの中断、ページ読み込みの遅延などによって、エンド ユーザーに影響を与える可能性があります。