How to: Create a Supplemental .config File

上次修改时间： 2012年4月19日

适用范围： SharePoint Foundation 2010

%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\CONFIG 文件夹包含 .config 和 .xml 文件，当使用 Microsoft SharePoint Foundation 扩展 Web 应用程序时，可将这两类文件一起使用以创建 Web 应用程序的 web.config 文件。在将 web.config 文件从 \CONFIG 文件夹复制到 Web 应用程序的根文件夹之前，SharePoint Foundation 会搜索 \CONFIG 文件夹中名称格式为 webconfig.*.xml 的所有 .xml 文件，并将其内容与 web.config 文件合并。.xml 文件中定义的操作适用于 Web 应用程序的配置设置。使用 .xml 文件来补充 web.config 文件的主要好处是：在升级 SharePoint Foundation 并覆盖 web.config 文件之后，不会丢失自定义配置。

示例

在 \CONFIG 目录中另存为 webconfig.myName.xml 时，下面的示例会添加一个安全控件，并替换在扩展 Web 应用程序时为生成的 web.config 文件创建的运行时筛选器。

<actions>
   <add path="configuration/SharePoint/SafeControls">
      <SafeControl
         Assembly="System.Web, Version=1.0.5000.0, Culture=neutral, 
            PublicKeyToken=b03f5f7f11d50a3a"
         Namespace="System.Web.UI.WebControls"
         TypeName="*"
         Safe="True"/>
   </add>
   <remove path="configuration/SharePoint/RuntimeFilter"/>
   <add path="configuration/SharePoint">
      <RuntimeFilter
         Assembly="Company.Product, Version=1.0.1000.0, 
            Culture=neutral, PublickKeyToken=1111111111"
         Class="MyRuntTimeFilter",
         BuilderUrl="MyBuilderUrl"/>
   </add>
</actions>

该示例会执行以下操作：在 Xpath configuration/SharePoint/SafeControls 上添加新的 SafeControl 子元素；从 Xpath configuration/SharePoint/RuntimeFilter 中删除 RuntimeFilter 元素；在 Xpath configuration/SharePoint 上添加新的 RuntimeFilter 元素。

反过来，可以通过运行 copyappbincontent Stsadm 命令行操作，将更改应用于服务器的 web.config 文件。在部署过程中，必须在每台前端 Web 服务器上运行此操作。

有关 SharePoint Foundation 部署中使用的 web.config 文件的常规信息，请参阅使用 Web.config 文件

警告
在安装 SharePoint Foundation 更新或 Service Pack，或将安装的版本升级到下一产品版本时，可能会覆盖对 SharePoint Foundation 中内置的或在创建 SharePoint Foundation Web 应用程序时创建的任一 web.config 文件所做的更改。因此，建议您不要直接编辑这些文件。可使用本主题中介绍的方法或如何：以编程方式添加和删除 Web.config 设置中介绍的方法更改 web.config 设置。通过使用这两种方法中的任一种，可以在升级后重新应用您的自定义设置。

请参阅

概念

使用 Web.config 文件

如何：以编程方式添加和删除 Web.config 设置