Como activar uma aplicação ASP.NET para ser executada num servidor virtual do SharePoint

Este artigo descreve como configurar uma aplicação ASP.NET para ser executada num servidor virtual que está a executar o Microsoft Windows SharePoint Services ou Microsoft Office SharePoint Portal Server 2003.

Para activar uma aplicação ASP.NET para ser executada num servidor que está a executar o Windows SharePoint Services ou SharePoint Portal Server 2003, configure uma exclusão para o caminho da aplicação no servidor virtual. A exclusão indica ao servidor que está a executar o SharePoint Portal Server 2003 não para interceptar o pedido para aceder ao servidor virtual e deixar o servidor ISS (Serviços de informação Internet Information Services) para processar o pedido.

Nota No Office SharePoint Server 2007, não é necessário configurar uma exclusão. No entanto, deve criar um directório virtual utilizando o Gestor do IIS. Além disso, deverá configurar o directório virtual como uma aplicação. A aplicação deve ter um ficheiro Web.config correspondente.

Para criar uma exclusão para uma parte do espaço de nomes do URL do servidor virtual, siga estes passos:

1. Clique em Iniciar , clique em Ferramentas administrativas e, em seguida, clique em ' Administração Central do SharePoint .
2. Na área Configuração do servidor virtual , clique em Configurar definições do servidor virtual .
3. No separador de Lista de servidores virtuais , clique no servidor virtual que tem de adicionar os caminhos excluídos.
4. Em Gestão do servidor virtual , clique em Definir caminhos geridos .
5. Na secção Adicionar um novo caminho , escreva o caminho que pretende excluir na caixa caminho .
6. Clique em Caminho excluído e, em seguida, clique em OK .

Por vezes, terá de mais do que acaba de definir o caminho excluídos. Alguns programas Web requerem que modifique o ficheiro Web.config para o servidor que esteja a executar o Windows SharePoint Services ou SharePoint Portal Server 2003. Para modificar o ficheiro Web.config, siga estes passos:

1. No servidor que hospeda a página Web que pretende configurar, localize o caminho que foi excluído dos passos anteriores deste artigo. O caminho será semelhante à seguinte:
   drive: \inetpub\wwwroot\ Excluded Path
2. Guarde uma cópia do ficheiro Web.config como Web2.config.
3. Abra o ficheiro Web.config.
4. Localize a tag de <system.web> e, em seguida, adicione o seguinte código sob a marca:

   <!-- 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. Guarde o ficheiro Web.config.
   
   Para obter informações adicionais sobre como criar um ficheiro Web.config para utilizar com o ASP.NET, clique no número de artigo que se segue para visualizar o artigo na Microsoft Knowledge Base:
   815179  (http://support.microsoft.com/kb/815179/ ) Como criar o ficheiro Web.config para uma aplicação do ASP.NET
6. Instale o módulo HTTP que é discutido no artigo da base de dados de conhecimento da Microsoft 887289 para procurar problemas com a colocação em forma canónica no ASP.NET. Depois de instalar o módulo, adicione a referência de módulo para o ficheiro Web.config da aplicação do ASP.NET que reside num caminho excluído do servidor virtual SharePoint Portal Server 2003.
   
   Nota O módulo não tem de ser adicionados ao ficheiro Web.config pelo SharePoint Portal Server 2003 na raiz do servidor virtual.
   
   Para adicionar a referência de módulo ao ficheiro Web.config da aplicação de ASP.NET, siga estes passos:
   1. Abra o ficheiro Web.config.
   2. Localize entradas <httpmodules> no interior da secção <system.web> que adicionou no passo 4 e, em seguida, adicione o seguinte código após a última entrada:

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

   3. Guarde o ficheiro Web.config.
   Para obter informações adicionais sobre problemas com a colocação em forma canónica no ASP.NET, clique os números de artigo seguinte para visualizar os artigos na base de dados de conhecimento da Microsoft:
   887289  (http://support.microsoft.com/kb/887289/ ) Módulo HTTP para verificar a existência de problemas relacionados com o ASP.NET a forma canónica
   887459  (http://support.microsoft.com/kb/887459/ ) Como testar programaticamente a existência de problemas com a colocação em forma canónica no ASP.NET

Nota Se não criar a exclusão para o servidor virtual, Windows SharePoint Services ou o SharePoint Portal Server 2003 irá devolver uma das seguintes mensagens de erro quando tenta visite qualquer um das páginas que está localizado no sistema de ficheiros: Nota Este problema ocorre porque todos os pedidos para aceder ao servidor virtual são interceptados pelo Windows SharePoint Services ou pelo SharePoint Portal Server 2003.