Configuration-Element (Website)
Letzte Änderung: Donnerstag, 11. Februar 2010
Gilt für: SharePoint Foundation 2010
Inhalt dieses Artikels
Attribute
Untergeordnete Elemente
Übergeordnete Elemente
Vorkommen
Gibt die Listen und Module zum Erstellen einer SharePoint Foundation-Website an, die auf der Konfiguration der Websitedefinition basiert, die vom 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. Nur falls anders angegeben, gelten die nachfolgenden Attributbeschreibungen für Configuration-Elemente in sowohl Websitedefinitionen als auch 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>
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-Wert. Gibt die URL einer anderen .master-Seite an, die auf Seiten von Websites angezeigt werden kann, die mithilfe der Konfiguration der Websitedefinition erstellt werden, ohne diese Seiten anzupassen.
Hinweis
Durch ein bloßes Ändern des Werts des MasterPageFile-Attributs auf Seiten, die eine andere Gestaltungsvorlage benötigen, würden diese Seiten so angepasst, dass sie in der Inhaltsdatenbank anstatt im Dateisystem der Front-End-Webserver gespeichert würden.
Weitere Informationen zur Verwendung des Werts von CustomMasterUrl finden Sie unter Gestaltungsseiten in Anwendungsseiten. |
Description |
Optionaler Text-Wert. Enthält die gebietsschemaspezifische Beschreibung der Konfiguration der Websitedefinition, die auf der Benutzeroberfläche von SharePoint Foundation angezeigt wird. |
DisplayCategory |
Optionaler Text-Wert. Gibt die Kategorie an, in der die Konfiguration der Websitedefinition auf der Benutzeroberfläche von SharePoint Foundation angezeigt wird, z. B. Collaboration, Meetings oder ein beliebiger benutzerdefinierter Name. |
FilterCategories |
Optionaler Text-Wert. Dieses Attribut wird von SharePoint Foundation nicht verwendet. Es steht für erweiterte auf SharePoint Foundation basierende Portal- und Inhaltsverwaltungslösungen, z. B. Microsoft SharePoint Server, als Möglichkeit der Kategorisierung von Websitekonfigurationen auf Weisen zur Verfügung, die den Kategorisierungen auf der Benutzeroberfläche nicht präzise zugeordnet werden können. (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 |
Erforderlicher Integer-Wert. Gibt eine ID für die Konfiguration der Websitedefinition an, die innerhalb der Websitedefinition eindeutig ist. Eine Definition, z. B. STS oder MSP, wird von einem Template-Element in einer WebTemp*.xml-Datei und von einer entsprechenden Onet.xml-Datei für die Definition bestimmt. Siehe Übergeordnete Elemente und Hinweise weiter unten. |
ImageUrl |
Erforderlicher Text-Wert. Enthält die URL des Vorschaubilds, das auf der Benutzeroberfläche von SharePoint Foundation angezeigt wird. |
MasterUrl |
Optionaler Text-Wert. Gibt die Standardgestaltungsvorlage für Websites an, die mithilfe der Konfiguration der Websitedefinition erstellt werden. |
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 weiter unten.) 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. Eine solche Klasse ist nicht erforderlich, doch falls Sie eine für eine benutzerdefinierte Konfiguration benötigen, muss sie von SPWebProvisioningProvider abhängig sein. Beispiel: ProvisionClass="MyCompany.SharePoint. ProvisionHelper.MySiteProvisioningProvider" |
ProvisionData |
Optionaler Text-Wert. Gibt Daten an, die von der Provision(SPWebProvisioningProperties)-Methode von ProvisionClass (siehe oben) verwendet werden. Dies kann ein Pfad zur Datei sein, die strukturierte Daten enthält. Beispiel: ProvisionData="SiteTemplates\\MySiteManifest.xml" |
RootWebOnly |
Optionaler Boolean-Wert. TRUE zum Angeben, dass die anhand der Konfiguration erstellte Website nur als die Stammwebsite in einer Websitesammlung vorhanden ist. Dieses Attribut wird nicht in Webvorlagen erzwungen, die in Lösungsdateien (.wsp) gespeichert werden. |
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 nicht in Webvorlagen erzwungen, die in Lösungsdateien (.wsp) gespeichert werden. |
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-Wert. Enthält den Titel der Konfiguration der Websitedefinition, der auf der Benutzeroberfläche von SharePoint Foundation angezeigt wird. |
Type |
Optionaler Text-Wert. Bestimmt die Websitedefinition, z. B. STS oder MPS. |
VisibilityFeatureDependency |
Optional Text-Wert. Wird in einer Datei vom Typ WebTemp*.xml zum Ausblenden der Konfiguration der Websitedefinition basierend auf dem Aktivierungsstatus des angegebenen Features verwendet. Wenn eine Konfiguration Features enthält, die von einem anderen Feature abhängig sind, 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 bzw. aktiviert ist. Dieses Attribut wird nicht für Features mit dem Gültigkeitsbereich "Webanwendung" 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 in einer Websitesammlung verfügbare Konfiguration einer Websitedefinition zu bestimmen. 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.xml ist dieses Element in einem Configurations-Element enthalten, das die Konfigurationen angibt, deren Listen in Onet.xml definiert sind.
Es gibt ein Template-Element je WebTemp*.xml-Datei und eine Onet.xml-Datei je Websitedefinition.
Das ID-Attribut ordnet das Configuration-Element einer angegebenen Websitedefinition in einer WebTemp*.xml-Datei dem entsprechenden Configuration-Element derselben Websitedefinition in der Onet.xml-Datei zu.
Eine Webvorlage wird im Unterschied zu einer Konfiguration einer Websitedefinition mithilfe eines WebTemplate-Elements in einer elements.xml-Datei innerhalb einer WSP-Datei definiert, die in einer SharePoint-Datenbank gespeichert wird. Die WSP-Datei enthält auch eine Onet.xml-Datei mit einem einzelnen Configuration-Element, das die Details der Webvorlage angibt.
Beispiel
Das folgende Beispiel von 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>