Partilhar via

Substituir padrões do Visualizador da Ajuda

Você pode alterar o comportamento padrão do Microsoft Help Viewer e recursos relacionados à ajuda no IDE do Visual Studio.

O Gerenciador de Conteúdo da Ajuda é uma ferramenta que você pode usar para implantar e gerenciar o conteúdo local do Visualizador da Ajuda. Para alterar o comportamento do Visualizador da Ajuda, você pode substituir as configurações padrão do programa executável do Gerenciador de Conteúdo da Ajuda HlpCtntMgr.exe.

Há diferentes maneiras de definir as opções do Gerenciador de Conteúdo da Ajuda:

  • Crie um arquivo .pkgdef para definir valores de chave do Registro.
  • Defina as opções diretamente no Registro.

Usar um arquivo .pkgdef para alterar o comportamento do Visualizador da Ajuda

Um arquivo .pkgdef armazena informações de configuração que o Visualizador da Ajuda usa. Você pode usar um arquivo .pkgdef para ajustar os valores de chave do Registro listados na tabela a seguir:

Valor da chave do Registro Tipo Data Description
NewContentAndUpdateService cadeia (de caracteres) <URL do ponto de extremidade do serviço> Definir um ponto de extremidade único para o serviço
UseOnlineHelp dword 0 para especificar a Ajuda local, 1 para especificar a Ajuda online Definir padrão da Ajuda online ou offline
OnlineBaseUrl cadeia (de caracteres) <URL do ponto de extremidade do serviço> Defina um endpoint exclusivo F1
Preferência de Ajuda Online Desativada dword 0 para ativar ou 1 desativar a opção de preferência Ajuda online Desativar a opção de preferência Ajuda online
DesativarGerirConteúdo dword 0 para ativar ou 1 desativar o separador Gerir Conteúdo no Visualizador da Ajuda Desative a guia Gerenciar conteúdo
DesativarSeleçãoDeAjudaNaPrimeiraExecução dword 0 para habilitar ou 1 desabilitar os recursos de ajuda configurados na primeira vez que o Visual Studio é iniciado Desabilitar a instalação de conteúdo na primeira inicialização do Visual Studio

Para definir valores de chave de registo num ficheiro .pkgdef, siga estes passos:

  1. Crie um novo arquivo e dê a ele a extensão .pkgdef.

  2. Adicione o seguinte texto à primeira linha do ficheiro:

    [$RootKey$\Help]

  3. Em linhas separadas, adicione qualquer um dos valores de chave do Registro descritos na tabela anterior. Por exemplo, você pode adicionar esta linha para configurar o UseOnlineHelp valor:

    "UseOnlineHelp"=dword:00000001

  4. Copie o arquivo para a pasta CommonExtensions de sua instalação do Visual Studio. Por exemplo:

    • Se você usar a edição Community do Visual Studio 2017, adicione o arquivo .pkgdef a esta pasta:

      C:\Arquivos de Programas (x86)\Microsoft Visual Studio\2017\Community\Common7\IDE\CommonExtensions

    • Se você usar a edição Community do Visual Studio 2022, adicione o arquivo .pkgdef a esta pasta:

      C:\Arquivos de Programas\Microsoft Visual Studio\2022\Community\Common7\IDE\CommonExtensions

  5. Em um prompt de comando do desenvolvedor, execute este comando:

    devenv /updateconfiguration

Exemplo de conteúdo do arquivo .pkgdef

[$RootKey$\Help]
"NewContentAndUpdateService"="https://some.service.endpoint"
"UseOnlineHelp"=dword:00000001
"OnlineBaseUrl"="https://some.service.endpoint"
"OnlineHelpPreferenceDisabled"=dword:00000000
"DisableManageContent"=dword:00000000
"DisableFirstRunHelpSelection"=dword:00000001

Usar o Editor do Registro para alterar o comportamento do Visualizador da Ajuda

Você pode controlar os seguintes tipos de comportamento definindo valores de chave do Registro no Editor do Registro.

Tarefa Chave do Registo Valor Data
Alterar a preferência de tarefa do BITS HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node (em uma máquina de 64 bits)\Microsoft\Help\v2.3 BITSPrioridade primeiro plano, alto, normal ou baixo
Indique o armazenamento de conteúdo local na partilha de rede HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Help\ v2.3\Catálogos\VisualStudio15 Caminho de Localização ContentStoreNetworkPartilha

Conteúdo relacionado

  • Last updated on