Gewusst wie: Erstellen einer ergänzenden .config-Datei

Letzte Änderung: Donnerstag, 19. April 2012

Gilt für: SharePoint Foundation 2010

Der Ordner %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\CONFIG enthält CONFIG- und XML-Dateien, die gemeinsam zum Erstellen der web.config-Datei für eine Webanwendung in Microsoft SharePoint Foundation verwendet werden. Bevor die web.config-Datei aus dem Ordner \CONFIG in den Stammordner der Webanwendung kopiert wird, durchsucht SharePoint Foundation den Ordner \CONFIG nach einer XML-Datei mit einem Namen im Format webconfig.*.xml und führt den Inhalt mit der web.config-Datei zusammen. Die in der XML-Datei definierten Aktionen werden auf die Konfigurationseinstellungen der Webanwendung angewendet. Ein großer Vorteil bei der Verwendung einer XML-Datei zum Ergänzen der web.config-Datei liegt darin, dass Anpassungen beim Upgrade von SharePoint Foundation und beim Überschreiben der web.config-Datei nicht verloren gehen.

Beispiel

Beim Speichern unter webconfig.meinName.xml im Verzeichnis \CONFIG wird im folgenden Verzeichnis ein sicheres Steuerelement hinzugefügt, das den beim Erweitern einer Webanwendung erstellten Laufzeitfilter der resultierenden web.config-Datei ersetzt.

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

Im Beispiel wird eine neues untergeordnetes SafeControl-Element im XPath configuration/SharePoint/SafeControls hinzugefügt, das RuntimeFilter-Element aus dem XPath configuration/SharePoint/RuntimeFilter entfernt und ein neues RuntimeFilter-Element im XPath configuration/SharePoint hinzugefügt.

Sie können im Nachhinein Änderungen auf die web.config-Dateien des Servers anwenden, indem Sie den copyappbincontent-Vorgang des Befehlszeilentools Stsadm verwenden. Sie müssen den Vorgang auf jedem Front-End-Webserver in der Bereitstellung ausführen.

Allgemeine Informationen zu den in einer SharePoint Foundation-Bereitstellung verwendetenweb.config-Dateien finden Sie unter Arbeiten mit Web.config-Dateien.

Vorsicht

Änderungen an web.config-Dateien, die in SharePoint Foundation integriert sind oder die beim Erstellen einer SharePoint Foundation-Webanwendung erstellt werden, werden möglicherweise überschrieben, wenn Sie Updates oder Service Packs für SharePoint Foundation installieren oder wenn Sie ein Upgrade einer Installation auf die nächste Produktversion ausführen. Aus diesem Grund wird davon abgeraten, diese Dateien direkt zu bearbeiten. Nehmen Sie Änderungen an den Einstellungen von web.config-Dateien mithilfe der in diesem Thema oder der unter Gewusst wie: Programmgesteuertes Hinzufügen und Entfernen von "Web.config"-Einstellungen beschriebenen Methode vor. Bei beiden Methoden können Ihre benutzerdefinierten Einstellungen nach dem Upgrade erneut angewendet werden.

Siehe auch

Konzepte

Arbeiten mit Web.config-Dateien

Gewusst wie: Programmgesteuertes Hinzufügen und Entfernen von "Web.config"-Einstellungen