Partilhar via

Depuração de extensões para as ferramentas do SharePoint em Visual Studio

  • Artigo

Você pode depurar extensões de ferramentas do SharePoint na instância de avaliação normal ou na instância do Visual Studio.Se você precisar solucionar o comportamento de uma extensão, você também pode alterar valores de Registro para exibir informações de erro adicional e para configurar como o Visual Studio executa comandos do SharePoint.

Extensões de depuração na instância de avaliação do Visual Studio

Para proteger o ambiente de desenvolvimento Visual Studio de danos acidental por extensões não experimentadas, o Visual Studio SDK fornece uma instância alternativo do Visual Studio, chamada a instância de avaliação, que você pode usar o para instalar e testar extensões.Você desenvolve novas extensões usando a instância normal do Visual Studio, mas você depurar-las e executar-l na instância de avaliação.Para obter mais informações, consulte Instância experimental do Visual Studio.

Se você usar um projeto de VSIX implantar sua extensão, e o projeto de VSIX são o projeto de inicialização em sua solução, instalações do Visual Studio automaticamente e executa a extensão na instância de avaliação quando você depura sua solução.O projeto de inicialização é o projeto que começa quando você depura uma solução que contém vários projetos.Para obter mais informações sobre como usar um projeto de VSIX implantar sua extensão, consulte Implantação de extensões para as ferramentas de SharePoint no Visual Studio.Para obter mais informações sobre projetos de inicialização, consulte [NIB] 12/13 Como escolher o projeto de inicialização.

Para exemplos que demonstram como depurar vários tipos de extensões na instância de avaliação do Visual Studio, consulte os seguintes passo a passo:

Extensões na instância de depuração normal do Visual Studio

Se você quiser depurar seu projeto de extensão na instância normal do Visual Studio, primeiro instalar a extensão na instância normal.Em seguida, anexar o depurador para um segundo processo do Visual Studio.Depois que você terminar, você pode remover a extensão para que não carrega no computador de desenvolvimento.

para instalar a extensão

  1. Feche todas as instâncias do Visual Studio.

  2. Em a pasta de saída de compilação para o projeto de extensão, abra o arquivo de .vsix clicando duas vezes no ou abrindo o menu de atalho e então escolha Abrir:

  3. Em a caixa de diálogo de Instalador de Extensão do Visual Studio , escolha a edição Visual Studio para o qual você deseja instalar a extensão, e então escolha o botão de Instalar .

    O Visual Studio instala os arquivos da extensão em %UserProfile%\AppData\Local\Microsoft\VisualStudio\11.0\Extensions\nome do autor\nome da extensão\versão.As três últimas as pastas em esse caminho são construídas de Author, Name, e os elementos de Version no extension.vsixmanifest arquivos para a extensão.

  4. Depois que o Visual Studio instala a extensão, escolha o botão de Fechar .

para depurar a extensão

  1. Inicie o Visual Studio com privilégios de administrador do e abra o projeto de extensão.As etapas a seguir faz referência a essa instância do Visual Studio porque a primeira instância.

  2. Iniciar outra instância do Visual Studio com privilégios de administrador.As etapas a seguir faz referência a essa instância do Visual Studio como a segunda instância.

  3. Alterne para a primeira instância do Visual Studio.

  4. Em a barra de menu, escolha Depurar, Anexar a Processo.

  5. Em a lista de Processos Disponíveis devenv.exe, escolha.Essa entrada refere-se a segunda instância do Visual Studio; esta é a instância que você deseja depurar em sua extensão do projeto.

  6. Escolha o botão de Anexar .

    O Visual Studio executa o projeto de extensão no modo de depuração.

  7. Alterne para a segunda instância do Visual Studio.

  8. Crie um novo projeto do SharePoint que carrega sua extensão.Por exemplo, se você está depurando uma extensão para itens de projeto de definição de lista, crie um projeto de listar a definição .

  9. Execute o etapas que são necessárias para testar seu código de extensão.

  10. Quando você terminar de depurar a extensão, feche a segunda instância do Visual Studio.

para remover a extensão

  1. Em o Visual Studio, na barra de menu, escolha Ferramentas, Extensões e Atualizações.

    a caixa de diálogo de Extensões e Atualizações abre.

  2. Em a lista de extensões, escolha a extensão, e então escolha o botão de Desinstalar .

  3. Em a caixa de diálogo que aparece, escolha o botão de Sim para confirmar que você deseja desinstalar a extensão.

  4. Escolha o botão de Reiniciar Agora para concluir a desinstalação.

Comandos do SharePoint de depuração

Se você quiser depurar um comando do SharePoint que é parte de ferramentas extensão do SharePoint, você deve anexar o depurador ao processo de vssphost4.exe.Este é o processo host de 64 bits que executa comandos do SharePoint.Para obter mais informações sobre comandos do SharePoint e de vssphost4.exe, consulte A chamada para os modelos de objeto do SharePoint.

para anexar o depurador ao processo de vssphost4.exe

  1. Inicie depurar a extensão na instância de avaliação do Visual Studio normal ou na instância do Visual Studio seguindo as declarações anteriores.

  2. Em a instância do Visual Studio em que você está executando o depurador, na barra de menu, escolha Depurar, Anexar a Processo.

  3. Em a lista de Processos Disponíveis , escolha vssphost.exe.

    ObservaçãoObservação

    Se vssphost.exe não aparece na lista, você deve iniciar o processo de vssphost4.exe na instância do Visual Studio em que você estiver executando a extensão.Normalmente, você faz isso executar uma ação que faz com que o Visual Studio se conecta ao site da web do SharePoint no computador de desenvolvimento.Por exemplo, o Visual Studio começa vssphost4.exe quando você expandir um nó de conexão do site (um nó que exibe um URL do site) sob o nó de Conexões do SharePoint na janela de Gerenciador de Servidores , ou quando você adiciona determinados itens de projeto do SharePoint, como Instância de lista ou itens de Receptor de eventos , a um projeto do SharePoint.

  4. Escolha o botão de Anexar .

  5. Em a instância do Visual Studio que está sendo depurado, execute as etapas que são necessárias para executar o comando.

Valores de Registro de alteração para ajudá-lo a depurar extensões de ferramentas do SharePoint

Quando você depura uma extensão de ferramentas do SharePoint no Visual Studio, você pode alterar valores no Registro para ajudar a resolver problemas a extensão.Os valores existem na chave de HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\11.0\SharePointTools .Esses valores não existem por padrão.

Para ajudar a resolver problemas qualquer extensão de ferramentas do SharePoint, você pode criar e definir o valor de EnableDiagnostics.A tabela a seguir descreve esse valor.

Valor

Descrição

EnableDiagnostics

REG_DWORD que especifica se as mensagens de diagnóstico são exibidas na janela de Saída .

Para exibir mensagens de diagnóstico, defina esse valor para 1.Para parar de exibir mensagens, defina esse valor para 0 ou excluir esses valores.

Para escrever mensagens para a janela de Saída do SharePoint faz uso de ferramentas a extensão, usa o serviço de projeto do SharePoint.Para obter mais informações, consulte Usando o serviço de projeto do SharePoint.

Se sua extensão inclui um comando do SharePoint, você pode criar e os valores adicionais do conjunto para ajudar a resolver problemas o comando.A tabela a seguir descreve esses valores.

Valor

Descrição

AttachDebuggerToHostProcess

REG_DWORD que especifica se exibir uma caixa de diálogo que permite que você anexe o depurador a vssphost4.exe portanto iniciar.Isso é útil se o comando que você deseja depurar é executado por vssphost.exe imediatamente depois de ele for iniciado, e não há muito tempo para anexar o depurador manualmente antes que o comando foi executado.Para exibir a caixa de diálogo, vssphost4.exe chama o método de Debugger.Break quando ele.

Para permitir esse comportamento, defina esse valor para 1.Para desativar esse comportamento, defina esse valor para 0 ou excluir esses valores.

Se você definir esse valor para 1, você pode também querer aumentar o valor de HostProcessStartupTimeout para dar se tempo suficiente para anexar o depurador antes do Visual Studio esperar vssphost4.exe sinalizar que iniciou com êxito.

ChannelOperationTimeout

REG_DWORD que especifica o tempo, em segundos, que as espera do Visual Studio para o SharePoint comando para executar.Se o comando não executa o tempo, SharePointConnectionException é lançada.

O padrão é 120 segundos.

HostProcessStartupTimeout

REG_DWORD que especifica o tempo, em segundos, o Visual Studio espera vssphost4.exe para sinalizar que iniciou com êxito.Se vssphost4.exe não sinaliza um inicie com êxito no tempo, SharePointConnectionException é lançada.

O padrão é 60 segundos.

MaxReceivedMessageSize

REG_DWORD o máximo permitiu que especifica o tamanho, em bytes, as mensagens WCF que são passados entre o Visual Studio e vssphost4.exe.

O padrão é 1.048.576 bytes (1 MB.)

MaxStringContentLength

REG_DWORD o máximo permitiu que especifica o tamanho, em bytes, de cadeias de caracteres que são passados entre o Visual Studio e vssphost4.exe.

O padrão é 1.048.576 bytes (1 MB.)

Consulte também

Conceitos

Implantação de extensões para as ferramentas de SharePoint no Visual Studio

Outros recursos

Estender as ferramentas do SharePoint em Visual Studio