Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Este tópico aborda vários problemas que você pode encontrar ao empacotar e implantar soluções do SharePoint.
Habilitar depuração aprimorada
Para diagnosticar entre Visual Studio, SharePoint e outras camadas, você pode usar a chave do Registro EnableDiagnostics para exibir o rastreamento de pilha. Para obter mais informações, consulte Depurar soluções do SharePoint.
Adicionar saída do projeto ao pacote de solução
Você pode adicionar a saída do projeto a um pacote por meio do Designer de Pacotes. No entanto, ao adicionar a saída do projeto, certifique-se de que a plataforma do projeto corresponde à plataforma da solução do SharePoint. Recomendamos que você use o destino Qualquer plataforma de CPU para os assemblies que deseja implantar em um servidor do SharePoint. Para obter mais informações, consulte Página de compilação, Designer de projeto (Visual Basic) e Caixa de diálogo Configurações avançadas do compilador (Visual Basic).
Avisos e erros de validação
As ferramentas de desenvolvimento do SharePoint no Visual Studio executam etapas de validação para verificar se o pacote de solução está formado corretamente. Você também pode criar etapas de validação personalizadas para seus recursos e pacotes. Para obter mais informações, consulte Como criar regras personalizadas de validação de recursos e pacotes para soluções do SharePoint.
Resolução de conflitos de implantação
Ao implantar uma solução do SharePoint, você pode encontrar colisões quando um item no servidor tem o mesmo nome, URL ou ID que um item em seu pacote de solução. Você pode alterar a propriedade Resolução de Conflitos de Implantação para resolver, relatar ou ignorar colisões de módulos, Web Parts, instâncias de lista e tipos de conteúdo.
A tabela a seguir demonstra as configurações da propriedade Resolução de Conflitos de Implantação .
| Valor | Description |
|---|---|
| Automático | Deteta colisões e resolve os conflitos automaticamente. |
| Pronta | Deteta colisões e as relata ao desenvolvedor antes de resolver os conflitos. |
| Nenhum | Não deteta colisões. |
Diferenças entre implantação F5
Quando você usa o Visual Studio para implantar seu projeto do SharePoint no servidor local do SharePoint para teste e depuração, há algumas etapas adicionais que são executadas pelo Visual Studio.
Redefina o Serviço de Informações da Internet (IIS) durante a etapa de implantação.
Associe fluxos de trabalho automaticamente.
Defina a ordem de ativação do recurso de acordo com a hierarquia no Designer de Pacotes.
Você pode adicionar etapas de implantação personalizadas para alterar ainda mais o comportamento F5 . Para obter mais informações, consulte Passo a passo: Criar uma etapa de implantação personalizada para projetos do SharePoint.
Atrasar a exibição da página do SharePoint ao implantar web part visual
A página do SharePoint leva muito tempo para aparecer ao implantar uma Web Part Visual na pasta Bin no Windows Vista, Windows 7 ou Windows Server 2008. Se você alterar quaisquer arquivos em um diretório ASP.NET de nível superior, como o diretório Bin, todo o aplicativo Web será recompilado. Isso pode causar um atraso de até 25 segundos para a renderização da página do SharePoint.
Mensagem de erro
Nenhum.
Resolução
Para contornar esse problema, execute as seguintes etapas:
Instale a atualização KB967535 conforme descrito no artigo de suporte da Microsoft correção: Um hotfix está disponível para corrigir dois problemas no ASP.NET no IIS 7.0 para Windows Vista e Windows Server 2008.
Adicione a seguinte linha ao ficheiro Web.config:
<compilation batch="false" optimizeCompilations="true">
A implantação do projeto do SharePoint falha com o erro "Falha ao extrair o arquivo cab na solução"
Se o nome de qualquer item de projeto do SharePoint contiver parênteses, sua solução falhará na implantação com um erro.
Mensagem de erro
Ocorreu um erro na etapa de implantação 'Adicionar solução': Falha ao extrair o arquivo cab na solução.
Resolução
Para contornar esse problema, remova todos os parênteses nos nomes de itens de projeto do SharePoint.
O erro aparece ao implantar uma Web Part visual num site numa aplicação web diferente.
Na primeira vez que você implantar uma Web Part visual em um site em um aplicativo Web diferente daquele em que ela está implantada atualmente (alterando a propriedade SiteUrl da Web Part visual), você receberá um erro.
Mensagem de erro
Ocorreu um erro na etapa de implantação 'Adicionar solução': um recurso com ID [#] já foi instalado neste farm. Utilize o atributo "force" para reinstalar explicitamente a funcionalidade.
Resolução
Este erro ocorre devido à forma como os recursos visuais da Web Part são retraídos no SharePoint. Para implantar com êxito a Web Part visual, volte a implantar a solução, escolhendo a tecla F5.
O aviso aparece ao implantar controles de usuário aninhados
Este aviso ocorre quando se implementa uma solução do SharePoint que tem controlos de utilizador aninhados, como uma Web Part visual que contém um controlo de utilizador ou um controlo de utilizador que contém uma Web Part visual ou outro controlo de utilizador. Esse aviso ocorre se você adicionar um controle a um designer arrastando-o da Caixa de Ferramentas ou usando a @Register diretiva na visualização Código-fonte.
Mensagem de erro
Aviso 1 O elemento '[Nome do Controlo]' não é um elemento conhecido. Isso pode ocorrer se houver um erro de compilação no site ou o arquivo web.config estiver faltando.
Resolução
Se o sistema de projeto do Visual Studio não estiver ciente de um controle de usuário aninhado, ele não pode fornecer IntelliSense e emite o aviso. O sistema de projeto não está ciente de um controle de usuário aninhado se o projeto não for criado e o designer não for fechado e reaberto, ou se a opção de retirada automática estiver habilitada, o que faz com que o controle de usuário seja retirado do hive do SharePoint após a depuração.
Para remover esse aviso, crie o projeto e, em seguida, feche e reabra o designer ou desative a opção de retratação automática para o projeto. Para fazer isso, desmarque a caixa de seleção Retratação automática após depuração na guia SharePoint da caixa de diálogo de propriedades do projeto.