Arbeiten mit Web.config-Dateien

  • Artikel

Letzte Änderung: Mittwoch, 28. Juli 2010

Gilt für: SharePoint Foundation 2010

Sie müssen u. U. web.config-Dateien ändern, damit die Lösung in der Microsoft SharePoint Foundation-Umgebung ausgeführt werden kann. So müssen Sie beispielsweise möglicherweise einen SafeControl-Eintrag hinzufügen, ein HttpModule registrieren oder einen SessionState anpassen. Eine SharePoint Foundation-Bereitstellung umfasst jedoch eine Vielzahl vonweb.config-Dateien. So existiert beispielsweise eine pro Webanwendung und jeweils eine Kopie davon auf jedem Front-End-Webserver.

Um das Anpassen von web.config-Dateien zu erleichtern, bietet SharePoint Foundation zwei Möglichkeiten zum Vornehmen von Änderungen. Erstens können Sie web.config-Einträge deklarativ registrieren, indem Sie eine XML-Datei erstellen, die eine Reihe von web.config-Änderungen enthält. Erstellen Sie hierzu eine benutzerdefinierte webconfig.XYZ.xml-Datei, die unter %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\CONFIG bereitgestellt wird, wobei XYZ eine eindeutige ID zum Identifizieren Ihrer Lösung ist. Ein Beispiel, in dem das Erstellen einer benutzerdefinierten web.config-Datei zum Ändern von Einstellungen veranschaulicht wird, finden Sie unter Gewusst wie: Erstellen einer ergänzenden .config-Datei.

Neben dem Erstellen einer ergänzenden webconfig.XYZ.xml-Datei können Sie web.config-Einstellungen auch über das SharePoint Foundation-Objektmodell ändern. Ein Beispiel zum programmgesteuerten Ändern von Einstellungen finden Sie unter Gewusst wie: Programmgesteuertes Hinzufügen und Entfernen von "Web.config"-Einstellungen.

Änderungen, die Sie über das Objektmodell oder im XML definieren, werden immer beim Erstellen einer Webanwendung angewendet.

Speicherorte von Web.config-Dateien

Web.config-Dateien sind im Dateisystem in den folgenden Ordnern enthalten:

  • \\Inetpub\wwwroot\wss\VirtualDirectories\Portnummer: Die web.config-Datei, die die Konfigurationseinstellungen für eine SharePoint-Inhaltswebanwendung definiert.

  • \\Inetpub\wwwroot\wss\VirtualDirectories\Portnummer_der_Zentraladministration: Die web.config-Datei, die Konfigurationseinstellungen für die Anwendung der SharePoint-Zentraladministration definiert.

  • \\Inetpub\wwwroot\wss\VirtualDirectories\Portnummer\wpresources: Die web.config-Datei, die in den Webpartressourcen der Webanwendung verwendet wird.

  • \\Program Files\Common Files\Microsoft Shared\Web Server Extensions\wpresources: Eine web.config-Datei, die in Webpartressourcen für den globalen Assemblycache verwendet wird.

    Wichtiger HinweisWichtig

    Die web.config-Dateien in den Ordnern \wpresources dürfen nicht geändert werden. Die Einstellungen dieser Dateien schließen Seiten oder Elemente aus, die kompiliert werden können. Wenn diese Einstellungen bearbeitet werden, unterscheidet sich der Sicherheitsstatus für den kompilierten Code beträchtlich vom Sicherheitsstatus für Code, der aus dem Verzeichnis Lokales_Laufwerk:\Inetpub\wwwroot ausgeführt wird.

  • %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\CONFIG: Die web.config-Datei und weitere .config-Dateien, die zusammen Konfigurationseinstellungen zum Erweitern anderer Webanwendungen definieren.

  • %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\ISAPI: Die web.config-Datei, die Konfigurationseinstellungen für das virtuelle Verzeichnis /_vti_bin definiert.

  • %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\LAYOUTS: Die web.config-Datei, die Konfigurationseinstellungen für das virtuelle Verzeichnis /_layouts definiert.

Wenn eine SharePoint Foundation-Webanwendung erstellt wird, wird eine web.config-Datei der obersten Ebene im Stammorder für Inhalte der Webanwendung platziert, wodurch Konfigurationseinstellungen für den Server definiert werden, beispielsweise die HTTP-Verarbeitung für Webparts. Eine weitere web.config-Datei für Webpartressourcen wird im Ordner \wpresources im selben Stammordner platziert.

VorsichtVorsicht

Änderungen, die Sie an einer der web.config-Dateien vornehmen, die in SharePoint Foundation integriert sind oder die beim Erstellen einer SharePoint Foundation-Webanwendung erstellt werden, werden möglicherweise beim Installieren von Upgrades oder Service Packs für SharePoint Foundation oder beim Aktualisieren einer Installation auf die nächste Produktversion überschrieben. Deshalb wird empfohlen, diese Dateien nicht direkt zu bearbeiten. Nehmen Sie Änderungen an web.config-Einstellungen entweder über die in Gewusst wie: Erstellen einer ergänzenden .config-Datei beschriebene Methode oder die in Gewusst wie: Programmgesteuertes Hinzufügen und Entfernen von "Web.config"-Einstellungen beschriebene Methode vor. Bei beiden Methoden können Ihre benutzerdefinierten Einstellungen nach dem Upgrade erneut angewendet werden.

Inhalt dieses Abschnitts

Siehe auch

Aufgaben

Gewusst wie: Auffinden des Webanwendungs-Stammverzeichnisses