Элемент Configuration (Site)

Статья
04/21/2015

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

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

В этой статье
Атрибуты
Дочерние элементы
Родительские элементы
Вхождения

Задает списки и модули, используемые при создании веб-сайта SharePoint Foundation на основе конфигурации определения сайта, представленной элементом Configuration. Эти элементы также представляют конфигурации в веб-шаблонах. Для большей простоты в этой статье применяется термин "конфигурация определения сайта", однако сведения в этой статье распространяются также на конфигурации веб-шаблонов. Если не указано иное, приведенные ниже определения применяются к элементам Configuration как в определениях сайта, так и в веб-шаблонах.

<Configuration
    AllowGlobalFeatureAssociations = "TRUE" | "FALSE"
    CustomMasterUrl = "Text"
    Description = "Text"
    DisplayCategory = "Text"
    FilterCategories = "Text"
    Hidden = "TRUE" | "FALSE"
    ID = "Integer"
    ImageUrl = "Text"
    MasterUrl = "Text"
    Name = "Text"
    ProvisionAssembly = "Text"
    ProvisionClass = "Text"
    ProvisionData = "Text"
    RootWebOnly = "TRUE" | "FALSE"
    SubWebOnly = "TRUE" | "FALSE"
    SupportsMultilingualUI = "TRUE" | "FALSE"
    Title = "Text"
    Type = "Text"
    VisibilityFeatureDependency = "Text">
</Configuration>

Атрибуты

AllowGlobalFeatureAssociations

Необязательный атрибут типа Boolean. Определяет, разрешены ли глобальные сопоставления компонентов для сайтов, создаваемых с использованием конфигурации определения сайта.

CustomMasterUrl

Необязательный атрибут типа Text. Определяет URL-адрес альтернативной страницы .master, которая может использоваться на страницах и веб-сайтах, создаваемых с использованием конфигурации определения сайта, без настройки таких страниц.

Простое изменение значения атрибута MasterPageFile на страницах, для которых требуется использовать альтернативную главную страницу, позволяет настроить такие страницы и сохранять их в базе контента, а не в файловой системе интерфейсного веб-сервера.

Дополнительные сведения об использовании значения атрибута CustomMasterUrl см. в статье Главные страницы на страницах приложений.

Description

Необязательный атрибут типа Text. Содержит зависящее от региональных параметров описание конфигурации определения сайта, которое отображается в пользовательском интерфейсе SharePoint Foundation.

DisplayCategory

Необязательный атрибут типа Text. Определяет категорию пользовательского интерфейса SharePoint Foundation, в которой отображается конфигурация определения сайта, например, Collaboration, Meetings или другое настраиваемое имя.

FilterCategories

Необязательный атрибут типа Text. Этот атрибут не используется в SharePoint Foundation. Он доступен для расширенных решений управления порталом или контентом на базе SharePoint Foundation, таких как Microsoft SharePoint Server, и используется для классификации конфигураций сайтов в точном соответствии с категориями их отображения в пользовательском интерфейсе. (См. также описание атрибута DisplayCategory.)

Hidden

Необязательный атрибут типа Boolean. Указывает, отображается ли конфигурация определения сайта в виде параметра пользовательского интерфейса SharePoint Foundation.

Обязательный параметр типа Integer. Задает идентификатор конфигурации определения сайта, являющийся уникальным для этого определения сайта. Определение, например STS или MPS, задается элементом Template в файле WebTemp*.xml и соответствующим файлом Onet.xml для определения. См. разделы Родительские элементы и Примечания ниже.

ImageUrl

Обязательный атрибут типа Text. Содержит URL-адрес изображения предварительного просмотра, отображаемого в пользовательском интерфейсе SharePoint Foundation.

MasterUrl

Необязательный атрибут типа Text. Задает главную страницу по умолчанию, которая используется для веб-сайтов, созданных с помощью этой конфигурации определения сайта.

Name

Необязательный атрибут типа Text. Содержит имя конфигурации определения сайта.

ProvisionAssembly

Необязательный атрибут типа Text. Задает имя сборки, которая содержит класс подготовки (если такой есть). (См. описание атрибута ProvisionClass ниже.) Например:

ProvisionAssembly="MyCompany.SharePoint.ProvisionHelper, Version=1.0.0.0, Culture=neutral, PublicKeyToken=82f0cdf222f0530d"

ProvisionClass

Необязательный атрибут типа Text. Задает полное имя класса, предоставляющего функции подготовки, которые выполняются после того, как будет завершено создание сайта на основе конфигурации средой выполнения. Наличие такого класса не обязательно, однако необходимо для использования настраиваемой конфигурации. Этот класс должен быть производным от класса SPWebProvisioningProvider. Например:

ProvisionClass="MyCompany.SharePoint. ProvisionHelper.MySiteProvisioningProvider"

ProvisionData

Необязательный атрибут типа Text. Определяет данные, которые будут использоваться методом Provision(SPWebProvisioningProperties) класса ProvisionClass (см. выше). Это может быть путь к файлу, содержащему структурированные данные. Например:

ProvisionData="SiteTemplates\\MySiteManifest.xml"

RootWebOnly

Необязательный атрибут типа Boolean. Значение TRUE указывает на то, что созданный на основе конфигурации сайт существует только в виде корневого веб-сайта в семействе сайтов. Этот атрибут не является обязательным в веб-шаблонах, которые хранятся в решении (файлы .wsp).

SubWebOnly

Необязательный атрибут типа Boolean. Значение TRUE указывает на то, что созданный на основе конфигурации сайт существует только в виде дочернего сайта в семействе сайтов. Этот атрибут не является обязательным в веб-шаблонах, которые хранятся в решении (файлы .wsp).

SupportsMultilingualUI

Необязательный атрибут типа Boolean. Значение TRUE (по умолчанию) указывает, что администраторы могут включать альтернативные языки для сайтов, созданных на основе конфигурации. Значение FALSE запрещает использование такой возможности администраторами.

Title

Необязательный атрибут типа Text. Содержит заголовок конфигурации определения сайта, который отображается в пользовательском интерфейсе SharePoint Foundation.

Type

Необязательный атрибут типа Text. Идентифицирует определение сайта, например, STS или MPS.

VisibilityFeatureDependency

Необязательный атрибут типа Text. Используется в файле WebTemp*.xml для скрытия конфигурации определения сайта на основе состояния активации указанного компонента. Когда конфигурация содержит компоненты, зависящие от другого компонента, установка данного атрибута предотвращает отображение конфигурации в виде параметра в пользовательском интерфейсе SharePoint Foundation, если указанный компонент не установлен или не активирован. Данный атрибут не поддерживается для компонентов с областью веб-приложения.

Дочерние элементы

ExecuteUrl, Lists, Modules, SiteFeatures, WebFeatures

Родительские элементы

Configurations, Template

Вхождения

Минимум: 0

Максимум: без ограничений

Примечания

Элемент Configuration используется в файлах WebTemp*.xml (см. описание файла WebTemp.xml) для идентификации доступной конфигурации определения сайта в определении сайта. Этот элемент используется в файлах Onet.xml для определения конфигурации списков, модулей и компонентов, которые используются для создания сайта на основе конфигурации определения сайта. В файле WebTemp*.xml этот элемент содержится в элементе Template, который задает определение сайта. В файле Onet.xml этот элемент содержится в элементе Configurations, задающем конфигурации, списки которых определены в файле Onet.xml.

Для каждого определения сайта существует один элемент Template в файле WebTemp*.xml и один файл Onet.xml.

Атрибут ID связывает элемент Configuration для указанного определения сайта в файле WebTemp*.xml с соответствующим элементом Configuration для этого же определения сайта в файле Onet.xml.

Веб-шаблон, в отличие от конфигурации определения сайта, задается в элементе WebTemplate файла elements.xml в WSP-файле, который хранится в базе данных SharePoint. Также в этом WSP-файле размещается файл Onet.xml с единственным элементом Configuration, в котором задаются сведения о веб-шаблоне.

Пример

В следующем примере из файла WebTemp.xml показано задание трех конфигураций для определения веб-сайта STS.

<Template Name="STS" ID="1">
    <Configuration ID="0" Title="Team Site" Hidden="FALSE" ImageUrl="/_layouts/images/stts.png" Description="A site for teams to quickly organize, author, and share information. It provides a document library, and lists for managing announcements, calendar items, tasks, and discussions." DisplayCategory="Collaboration" >    </Configuration>
    <Configuration ID="1" Title="Blank Site" Hidden="FALSE" ImageUrl="/_layouts/images/stbs.png" Description="A blank site for you to customize based on your requirements." DisplayCategory="Collaboration" AllowGlobalFeatureAssociations="False" >    </Configuration>
    <Configuration ID="2" Title="Document Workspace" Hidden="FALSE" ImageUrl="/_layouts/images/stdw.png" Description="A site for colleagues to work together on a document. It provides a document library for storing the primary document and supporting files, a tasks list for assigning to-do items, and a links list for resources related to the document." DisplayCategory="Collaboration" >    </Configuration>
 </Template>

См. также

Концепции

Веб-шаблоны

Определения и настройки сайта

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