Ermöglichen der Ausführung einer ASP.NET-Anwendung auf einem virtuellen SharePoint-Server

Dieser Artikel beschreibt, wie Sie eine ASP.NET-Anwendung für die Ausführung auf einem virtuellen Server unter Microsoft Windows SharePoint Services oder Microsoft Office SharePoint Portal Server 2003 konfigurieren.

Wenn Sie die Ausführung einer ASP.NET-Anwendung auf einem virtuellen Server unter Windows SharePoint Services oder SharePoint Portal Server 2003 ermöglichen möchten, konfigurieren Sie eine Ausschließung für den Anwendungspfad auf dem virtuellen Server. Mit der Ausschließung weisen Sie den SharePoint Portal Server 2003-Server an, die Anfrage für den Zugriff auf den virtuellen Server nicht abzufangen, sodass der Microsoft Internet Information Services (IIS)-Server die Anfrage bearbeiten kann.

Hinweis: In Office SharePoint Server 2007 brauchen Sie keine Ausschließung zu konfigurieren. Sie sollten jedoch mithilfe des IIS-Managers ein virtuelles Verzeichnis erstellen. Zusätzlich sollten Sie das virtuelle Verzeichnis als Anwendung konfigurieren. Für die Anwendung sollte es eine entsprechende Datei "Web.config" geben.

Gehen Sie folgendermaßen vor, um eine Ausschließung für einen Teil des URL-Namespace des virtuellen Servers zu erstellen:

1. Klicken Sie auf Start, klicken Sie auf Verwaltung und anschließend auf SharePoint-Zentraladministration.
2. Klicken Sie im Bereich Virtuellen Server konfigurieren auf Einstellungen virtueller Server konfigurieren.
3. Klicken Sie auf der Registerkarte Liste der virtuellen Server auf den virtuellen Server, zu dem Sie die ausgeschlossenen Pfade hinzufügen müssen.
4. Klicken Sie unter Verwaltung virtueller Server auf Verwaltete Pfade definieren.
5. Geben Sie im Bereich Neuen Pfad hinzufügen den Namen des auszuschließenden Pfades in das Feld Pfad ein.
6. Klicken Sie auf Ausgeschlossener Pfad und anschließend auf OK.

Manchmal müssen neben dem Festlegen des ausgeschlossenen Pfades weitere Schritte durchgeführt werden. Einige Webprogramme erfordern, dass Sie die Datei "Web.config" für den Windows SharePoint Services- oder SharePoint Portal Server 2003-Server ändern. Gehen Sie folgendermaßen vor, um die Datei "Web.config" zu ändern:

1. Suchen Sie auf dem Server, der die Webseite verwaltet, die Sie konfigurieren möchten, den ausgeschlossenen Pfad aus den vorangegangenen Schritten in diesem Artikel. Der Pfad sieht in etwa so aus:
   Laufwerk:\inetpub\wwwroot\Ausgeschlossener Pfad
2. Speichern Sie eine Sicherungskopie der Datei "Web.config" unter dem Namen "Web2.config".
3. Öffnen Sie die Datei "Web.config".
4. Suchen Sie den Tag <system.web>, und fügen Sie unter dem Tag den folgenden Code hinzu:

   <!-- Setup the PageHandlerFactory to process all requests. This will override the SharePoint HTTPHandler. -->
    
   <httpHandlers>
   <add verb="*" path="*.aspx" type="System.Web.UI.PageHandlerFactory, System.Web, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
   </httpHandlers>
    
   <!-- Set the trust back to Full. WSS configures a very restrictive trust policy that does not allow most applications to run correctly. -->
    
   <trust level="Full" originUrl="" />
    
   <!--
   	Enable the modules that you must have for your program to run.
   	If you receive the following message:
   	Parser Error Message: The module '<moduleName>' is already in the program and cannot be added again
   	You can remove the modules that are mentioned in the error message. The SharePoint web.config already includes the module for OutputCache and WindowsAuthentication so you do not have to add them here.
   -->
    
   <httpModules>
   <add name="Session" type="System.Web.SessionState.SessionStateModule"/>
   <add name="FormsAuthentication" type="System.Web.Security.FormsAuthenticationModule"/>
   <add name="PassportAuthentication" type="System.Web.Security.PassportAuthenticationModule"/>
   <add name="UrlAuthorization" type="System.Web.Security.UrlAuthorizationModule"/>
   <add name="FileAuthorization" type="System.Web.Security.FileAuthorizationModule"/>
   </httpModules>
    
   <!-- Enable Session for the pages -->
    
   <pages enableSessionState="true" enableViewState="true" enableViewStateMac="true" validateRequest="false" />

5. Speichern Sie die Datei "Web.config".
   
   Weitere Informationen zum Erstellen einer Datei "Web.config" für die Verwendung mit ASP.NET finden Sie im folgenden Artikel der Microsoft Knowledge Base:
   815179  (http://support.microsoft.com/kb/815179/DE/ ) Erstellen der Datei Web.config für eine Asp.net-anwendung
6. Installieren Sie das im Microsoft Knowledge Base-Artikel 887289 beschriebene HTTP-Modul, um nach Kanonisierungsproblemen bei ASP.NET zu suchen. Nachdem Sie das Modul installiert haben, fügen Sie den Modulverweis zu Ihrer Datei "Web.config" für Ihre ASP.NET-Anwendung hinzu, die sich unter einem ausgeschlossenen Pfad des virtuellen SharePoint Portal Server 2003-Servers befindet.
   
   Hinweis: Das Modul muss nicht zu der Datei "Web.config" hinzugefügt werden, die SharePoint Portal Server 2003 am Stamm des virtuellen Servers verwendet.
   
   Gehen Sie folgendermaßen vor, um den Modulverweis auf die Datei "Web.config" zu Ihrer ASP.NET-Anwendung hinzuzufügen:
   1. Öffnen Sie die Datei "Web.config".
   2. Suchen Sie die <httpModules>-Einträge im Abschnitt <system.web>, die Sie in Schritt 4 hinzugefügt haben, und fügen Sie nach dem letzten Eintrag den folgenden Code hinzu:

      <add name="ValidatePathModule" type="Microsoft.Web.ValidatePathModule, Microsoft.Web.ValidatePathModule, Version=1.0.0.0, Culture=neutral, PublicKeyToken=eba19824f86fdadd"/>

   3. Speichern Sie die Datei "Web.config".
   Weitere Informationen zu Kanonisierungsproblemen bei ASP.NET finden Sie in den folgenden Artikeln der Microsoft Knowledge Base:
   887289  (http://support.microsoft.com/kb/887289/DE/ ) HTTP-Modul zur Prüfung auf Kanonisierungsprobleme bei ASP.NET
   887459  (http://support.microsoft.com/kb/887459/DE/ ) Programmatische Überprüfung auf Kanonisierungsprobleme bei ASP.NET

Hinweis: Wenn Sie keine Ausschließung für den virtuellen Server erstellen, wird in Windows SharePoint Services oder SharePoint Portal Server 2003 eine der folgenden Fehlermeldungen angezeigt, wenn Sie versuchen, eine der auf dem Dateisystem befindlichen Seiten zu besuchen: Hinweis: Dieses Problem tritt auf, weil alle Anfragen für den Zugriff auf den virtuellen Server von Windows SharePoint Services oder SharePoint Portal Server 2003 abgefangen werden.