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

Создание дополнительного CONFIG-файла

  • Статья

Дата последнего изменения: 19 апреля 2012 г.

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

CONFIG- и XML-файлы, содержащиеся в папке %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\CONFIG, используются для создания файла web.config веб-приложения в Microsoft SharePoint Foundation. Перед копированием файла web.config из папки \CONFIG в корневую папку веб-приложения SharePoint Foundation выполняет в папке \CONFIG поиск любых XML-файлов с именем в формате webconfig.*.xml и объединяет их содержимое с файлом web.config. Действия, заданные в XML-файле, применяются к параметрам конфигурации веб-приложения. Большим преимуществом использования XML-файла в качестве дополнения к файлу web.config является то, что настройки не теряются при обновлении SharePoint Foundation и перезаписи файла web.config.

Пример

Следующий пример (при сохранении webconfig.myName.xml в папке \CONFIG) добавляет безопасный элемент управления и заменяет фильтр среды выполнения в итоговом файле 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>

В примере добавляется новый дочерний элемент SafeControl по пути Xpath configuration/SharePoint/SafeControls, удаляется элемент RuntimeFilter по пути Xpath configuration/SharePoint/RuntimeFilter и добавляется новый элемент RuntimeFilter по пути Xpath configuration/SharePoint.

Чтобы применить изменения к файлам web.config на сервере позже, выполните операцию командной строки Stsadm copyappbincontent. Эту операцию необходимо выполнить на каждом интерфейсном веб-сервере в развертывании.

Общие сведения о файлах web.config, используемых в развертываниях SharePoint Foundation, см. в статье Работа с файлами Web.config.

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

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

См. также

Концепции

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

Практическое руководство. Добавление и удаление параметров Web.config программным способом