通过

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.config 更改全局应用于服务器上的每个 Web 应用程序。为了创建适用于每个内容 Web 应用程序的 web.config 文件，这些附加的 web.config 文件被合并在一起。下面是 Microsoft Office Project Server 2007 自带的附加 web.config 文件（即 webconfig.pwa.xml）的示例。

<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 文件，都可能会触发应用程序域重新加载，这可能会导致缓存删除、会话状态丢失、处理失败、下载/上载间断或页面加载延迟，从而影响最终用户。