Поделиться через

Работа с файлами Web.config

  • Статья

Дата последнего изменения: 28 июля 2010 г.

Применимо к: SharePoint Foundation 2010

Для обеспечения работоспособности решения в среде Microsoft SharePoint Foundation может потребоваться внести изменения в файлы web.config. Например, может потребоваться добавить запись SafeControl, зарегистрировать модуль HttpModule или настроить SessionState, однако развертывание SharePoint Foundation включает большое количество файлов web.config. Например, такой файл создается для каждого веб-приложения, а копия каждого из этих файлов хранится на каждом интерфейсном веб-сервере.

Для упрощения настройки файлов web.configSharePoint Foundation предоставляет два способа внесения изменений. Во-первых, можно декларативно зарегистрировать записи web.config, создав XML-файл с набором изменений web.config. Для этого необходимо создать в папке %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\CONFIG настраиваемый файл webconfig.XYZ.xml, где XYZ — это уникальный идентификатор решения. Пример создания настраиваемого файла web.config для изменения параметров см. в статье Создание дополнительного CONFIG-файла.

Помимо создания вспомогательного файла webconfig.XYZ.xml для изменения параметров web.config также можно воспользоваться объектной моделью SharePoint Foundation. Пример программного изменения параметров см. в статье Практическое руководство. Добавление и удаление параметров Web.config программным способом.

Изменения, определяемые через объектную модель или с помощью XML, всегда применяются при создании веб-приложения.

Расположение файлов Web.config

Файлы Web.config хранятся в файловой системе в следующих папках:

  • \\Inetpub\wwwroot\wss\VirtualDirectories\номер_порта — файл web.config с параметрами конфигурации для веб-приложения контента SharePoint.

  • \\Inetpub\wwwroot\wss\VirtualDirectories\номер_порта_центра_администрирования — файл web.config с параметрами конфигурации для приложения центра администрирования SharePoint.

  • \\Inetpub\wwwroot\wss\VirtualDirectories\номер_порта\wpresources — файл web.config, используемый в ресурсах веб-частей веб-приложения.

  • \\Program Files\Common Files\Microsoft Shared\Web Server Extensions\wpresources — файл web.config, используемый в ресурсах веб-частей для глобального кэша сборок.

    Важное примечаниеВажно!

    Файлы web.config в папках \wpresources изменять не следует. Параметры этих файлов запрещают использование компилируемых страниц и элементов. При изменении этих параметров состояние безопасности для скомпилированного кода может существенно измениться по сравнению с состоянием безопасности для кода, запускаемого из каталога локальный_диск:\Inetpub\wwwroot.

  • %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\CONFIG — файл web.config и другие файлы .config, совместно определяющие параметры конфигурации для расширения других веб-приложений.

  • %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\ISAPI — файл web.config с параметрами конфигурации для виртуального каталога /_vti_bin.

  • %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\LAYOUTS — файл web.config с параметрами конфигурации для виртуального каталога /_layouts.

При создании веб-приложения SharePoint Foundation в корневую папку контента веб-приложения помещается файл web.config верхнего уровня, определяющий параметры конфигурации сервера, например параметры обработки HTTP для веб-частей. Другой файл web.config, используемый для ресурсов веб-частей, помещается в папку \wpresources, расположенную в корневой папке.

Предупреждающая заметкаВнимание!

Изменения, внесенные в любой из файлов web.config, встроенных в SharePoint Foundation или созданных при создании веб-приложения SharePoint Foundation, могут быть перезаписаны при установке обновлений или пакетов обновления для SharePoint Foundation, а также при обновлении до следующей версии продукта. По этой причине не рекомендуется вносить непосредственные изменения в эти файлы. Измените параметры web.config с помощью способа, описанного в статье Создание дополнительного CONFIG-файла, или способа, описанного в статье Практическое руководство. Добавление и удаление параметров Web.config программным способом. При использовании любого из этих способов настраиваемые параметры можно заново применить после обновления.

Содержание

См. также

Задачи

Поиск корня веб-приложения