Konfigurationselement (Standort)

Artikel
04/08/2023

Gilt für: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Gibt die Listen und Module an, die zum Erstellen einer SharePoint Foundation-Website verwendet werden, die auf der Websitedefinitionskonfiguration basiert, die durch das Configuration-Element dargestellt wird. Diese Elemente stellen auch Konfigurationen in Webvorlagen dar.

Der Einfachheit halber wird der Terminus "Konfiguration der Websitedefinition" in diesem gesamten Thema verwendet, obwohl das Thema auch für Webvorlagenkonfigurationen gilt. Sofern nicht anders angegeben, gelten die folgenden Attributbeschreibungen für Konfigurationselemente in Websitedefinitionen und Webvorlagen.

<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>

Elemente und Attribute

In den folgenden Abschnitten werden Attribute, untergeordnete und übergeordnete Elemente erläutert.

Attribute

Attribut	Beschreibung
AllowGlobalFeatureAssociations	Optionaler Boolean-Wert. Gibt an, ob globale Featurezuordnungen für Websites zulässig sind, die mittels der Konfiguration der Websitedefinition erstellt werden.
CustomMasterUrl	Optionaler Text. Gibt die URL für eine alternative an. master Seite, die auf Seiten in Websites verwendet werden kann, die über die Konfiguration der Websitedefinition erstellt werden, ohne diese Seiten anzupassen. HINWEIS: Das einfache Ändern des Werts des MasterPageFile-Attributs auf Seiten, die eine alternative master Seite benötigen, würde diese Seiten anpassen und dazu führen, dass sie in der Inhaltsdatenbank und nicht im Dateisystem der Front-End-Webserver gespeichert werden. Weitere Informationen zur Verwendung des Werts von CustomMasterUrl finden Sie unter Gestaltungsvorlagen auf Anwendungsseiten.
Beschreibung	Optionaler Text. Enthält die gebietsschemaspezifische Beschreibung der Websitedefinitionskonfiguration, die auf der Benutzeroberfläche von SharePoint Foundation angezeigt wird.
DisplayCategory	Optionaler Text. Gibt die Kategorie an, in der die Websitedefinitionskonfiguration auf der Benutzeroberfläche von SharePoint Foundation angezeigt wird, z. B. Zusammenarbeit, Besprechungen oder ein benutzerdefinierter Name.
FilterKategorien	Optionaler Text. Dieses Attribut wird von SharePoint Foundation nicht verwendet. Es ist für erweiterte Portal- oder Inhaltsverwaltungslösungen verfügbar, die auf SharePoint Foundation basieren, z. B. Microsoft SharePoint Server, um Websitekonfigurationen auf eine Weise zu kategorisieren, die nicht genau den Kategorisierungen in der Benutzeroberfläche zugeordnet ist. (Siehe auch das DisplayCategory-Attribut.)
Hidden	Optionaler Boolean-Wert. Gibt an, ob die Konfiguration der Websitedefinition als Option auf der Benutzeroberfläche von SharePoint Foundation angezeigt wird.
ID	Erforderliche ganze Zahl. Gibt eine ID für die Konfiguration der Websitedefinition an, die innerhalb der Websitedefinition eindeutig ist. Eine Definition, z. B. STS oder MPS, wird durch ein Template-Element in einer `WebTemp.xml` Datei und durch eine entsprechende `Onet.xml` Datei für die Definition definiert. Siehe Übergeordnete Elemente* und Hinweise weiter unten.
ImageUrl	Erforderlicher Text. Enthält die URL für das Vorschaubild, das auf der Benutzeroberfläche von SharePoint Foundation angezeigt wird.
MasterUrl	Optionaler Text. Gibt die Standardseite master an, die für Websites verwendet werden soll, die über die Konfiguration der Websitedefinition erstellt wurden.
Name	Optionaler Text-Wert. Enthält den Namen der Konfiguration der Websitedefinition.
ProvisionAssembly	Optionaler Text-Wert. Gibt den Namen der Assembly an, die die Bereitstellungklasse enthält, sofern vorhanden. (Siehe ProvisionClass unten.) Zum Beispiel: `ProvisionAssembly="MyCompany.SharePoint.ProvisionHelper, Version=1.0.0.0, Culture=neutral, PublicKeyToken=82f0cdf222f0530d"`
ProvisionClass	Optionaler Text-Wert. Gibt den vollqualifizierten Domänennamen einer Klasse an, die Bereitstellungsfunktionalität bereitstellt und ausgeführt wird, sobald die Laufzeit das Erstellen einer Website anhand der Konfiguration abgeschlossen hat. Es ist nicht erforderlich, dass eine solche Klasse vorhanden ist, aber wenn Sie eine für eine benutzerdefinierte Konfiguration benötigen, muss sie von SPWebProvisioningProvider abgeleitet werden. Zum Beispiel: `ProvisionClass="MyCompany.SharePoint. ProvisionHelper.MySiteProvisioningProvider"`
ProvisionData	Optionaler Text. Gibt Daten an, die von der Provision(SPWebProvisioningProperties) -Methode der ProvisionClass verwendet werden (siehe oben). Dies kann ein Pfad zur Datei sein, die strukturierte Daten enthält. Zum Beispiel: `ProvisionData="SiteTemplates\\MySiteManifest.xml"`
RootWebOnly	Optionaler Boolean-Wert. TRUE , um anzugeben, dass die anhand der Konfiguration erstellte Website nur als Stammwebsite in einer Websitesammlung vorhanden ist. Dieses Attribut wird in Webvorlagen, die in Projektmappen (`.wsp` Dateien) gespeichert sind, nicht erzwungen.
SubWebOnly	Optionaler Boolean-Wert. TRUE zum Angeben, dass die anhand der Konfiguration erstellte Website nur als Unterwebsite in einer Websitesammlung vorhanden ist. Dieses Attribut wird in Webvorlagen, die in Projektmappen (`.wsp` Dateien) gespeichert sind, nicht erzwungen.
SupportsMultilingualUI	Optionaler Boolean-Wert. TRUE (Standard) zum Angeben, dass Administratoren andere Sprachen für Websites aktivieren können, die anhand der Konfiguration erstellt wurden. FALSE hindert Administratoren am Aktivieren dieser Funktionalität.
Title	Optionaler Text. Enthält den Titel der Websitedefinitionskonfiguration, die auf der Benutzeroberfläche von SharePoint Foundation angezeigt wird.
Typ	Optionaler Text-Wert. Bestimmt die Websitedefinition, z. B. STS oder MPS.
VisibilityFeatureDependency	Optionaler Text. Wird in einer `WebTemp*.xml` Datei verwendet, um die Konfiguration der Websitedefinition basierend auf dem Aktivierungsstatus des angegebenen Features auszublenden. Wenn eine Konfiguration Features enthält, die von einem anderen Feature abhängen, verhindert das Festlegen dieses Attributs, dass die Konfiguration als Option auf der Benutzeroberfläche von SharePoint Foundation angezeigt wird, wenn das angegebene Feature nicht installiert oder aktiviert ist. Dieses Attribut wird für Features mit Webanwendungsbereich nicht unterstützt.

Untergeordnete Elemente

Übergeordnete Elemente

Vorkommen

Minimum: 0
Maximum: Unbegrenzt

Hinweise

Ein Configuration-Element wird in WebTemp*.xml Dateien (siehe WebTemp.xml) verwendet, um eine verfügbare Websitedefinitionskonfiguration innerhalb einer Websitedefinition zu identifizieren.

Es dient in Onet.xml-Dateien zum Definieren einer Konfiguration von Listen, Modulen und Features, mit deren Hilfe eine Website anhand der Konfiguration der Websitedefinition erstellt wird.

In einer WebTemp*.xml Datei ist dieses Element in einem Template-Element enthalten, das die Websitedefinition angibt. In Onet.xmlist dieses Element in einem Configurations-Element enthalten, das die Konfigurationen angibt, deren Listen in Onet.xmldefiniert sind.

Es gibt ein Template-Element in einer WebTemp*.xml Datei und eine Onet.xml Datei für jede Websitedefinition.

Das ID-Attribut ordnet das Configuration-Element für eine bestimmte Websitedefinition in einer WebTemp*.xml Datei dem entsprechenden Configuration-Element für dieselbe Websitedefinition in zu Onet.xml.

Eine Webvorlage, die sich von einer Websitedefinitionskonfiguration unterscheidet, wird mit einem WebTemplate-Element in einer elements.xml Datei in einer WSP-Datei definiert, die in der SharePoint-Datenbank gespeichert ist. Außerdem befindet sich in der WSP-Datei eine Onet.xml Datei mit einem einzelnen Configuration-Element , das die Details der Webvorlage angibt.

Beispiel

Das folgende Beispiel aus WebTemp.xml gibt die drei Konfigurationen für die STS-Websitedefinition an.

<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>

Freigeben über