使用 Web.config 文件

上次修改时间： 2010年7月28日

适用范围： SharePoint Foundation 2010

您可能需要修改 web.config 文件，才能使您的解决方案在 Microsoft SharePoint Foundation 环境中有效。例如，您可能需要添加一个 SafeControl 项，注册 HttpModule，或自定义 SessionState，但是部署 SharePoint Foundation 将需要大量的 web.config 文件。例如，每个 Web 应用程序对应一个文件，并且每台前端 Web 服务器中包含每个这些文件的副本。

为了更加轻松地自定义 web.config 文件，SharePoint Foundation 提供了两种更改方式。第一种方式是通过创建包含一组 web.config 修改的 XML 文件以声明方式注册 web.config 项。为此，您需要创建一个已部署到 %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\CONFIG 中的自定义 webconfig.XYZ.xml 文件，其中，XYZ 是您用于标识自己的解决方案的唯一 ID。有关演示如何创建自定义 web.config 文件以更改设置的示例，请参阅How to: Create a Supplemental .config File。

除了创建补充 webconfig.XYZ.xml 文件之外，您还可以使用 SharePoint Foundation 对象模型来修改 web.config 设置。有关演示如何以编程方式修改设置的示例，请参阅如何：以编程方式添加和删除 Web.config 设置。

在创建 Web 应用程序时，始终会应用通过对象模型或 XML 定义的更改。

Web.config 文件位置

Web.config 文件包含在文件系统中的以下文件夹中：

• \\Inetpub\wwwroot\wss\VirtualDirectories\端口号 — 为 SharePoint 内容 Web 应用程序定义配置设置的 web.config 文件。

• \\Inetpub\wwwroot\wss\VirtualDirectories\管理中心的端口号 — 为 SharePoint 管理中心应用程序定义配置设置的 web.config 文件。

• \\Inetpub\wwwroot\wss\VirtualDirectories\端口号\wpresources — 在 Web 应用程序的 Web 部件资源中使用的 web.config 文件。

• \\Program Files\Common Files\Microsoft Shared\Web Server Extensions\wpresources — 在全局程序集缓存的 Web 部件资源中使用的 web.config 文件。

  重要信息
  不应修改 \wpresources 文件夹中的 web.config 文件。这些文件的设置不允许可编译的页面或项目。如果更改了这些设置，则已编译代码的安全状态将与从本地驱动器:\Inetpub\wwwroot 目录运行的代码的安全状态大不相同。

• %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\CONFIG — 共同定义用于扩展其他 Web 应用程序的配置设置的 web.config 文件和其他 .config 文件。

• %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\ISAPI — 为 /_vti_bin 虚拟目录定义配置设置的 web.config 文件。

• %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\LAYOUTS — 为 /_layouts 虚拟目录定义配置设置的 web.config 文件。

在创建 SharePoint Foundation Web 应用程序时，顶级 web.config 文件位于 Web 应用程序的内容根文件夹中，该文件为服务器定义配置设置（例如，Web 部件的 HTTP 处理）。用于 Web 部件资源的另一个 web.config 文件位于同一根文件夹中的 \wpresources 文件夹中。

警告
安装 SharePoint Foundation 的更新或 Service Pack 时，或者将安装升级到下一个产品版本时，可能会覆盖您对 SharePoint Foundation 中内置的或创建 SharePoint Foundation Web 应用程序时创建的任何 web.config 文件进行的更改。为此，建议您不要直接编辑这些文件。使用How to: Create a Supplemental .config File中介绍的方法或如何：以编程方式添加和删除 Web.config 设置 中介绍的方法来更改 web.config 设置。无论使用哪一种方法，升级后都可以重新应用您的自定义设置。

本节内容

• How to: Create a Supplemental .config File

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

请参阅

任务

如何：查找 Web 应用程序根目录