Condividi tramite


Sovrascrivere le impostazioni predefinite del Visualizzatore della Guida

È possibile modificare il comportamento predefinito di Microsoft Help Viewer e le funzionalità correlate alla Guida nell'IDE di Visual Studio.

Help Content Manager è uno strumento che è possibile usare per distribuire e gestire il contenuto di Help Viewer locale. Per modificare il comportamento di Help Viewer, è possibile eseguire l'override delle impostazioni predefinite del programma eseguibile Help Content Manager HlpCtntMgr.exe.

Esistono diversi modi per impostare le opzioni del Gestore dei contenuti della Guida.

  • Creare un file con estensione pkgdef per impostare i valori delle chiavi del Registro di sistema.
  • Impostare le opzioni direttamente nel Registro di sistema.

Usare un file con estensione pkgdef per modificare il comportamento di Help Viewer

Un file con estensione pkgdef archivia le informazioni di configurazione usate da Help Viewer. È possibile usare un file con estensione pkgdef per modificare i valori delle chiavi del Registro di sistema elencati nella tabella seguente:

Valore della chiave del Registro di sistema TIPO Data Description
ServizioDiNuovoContenutoEAggiornamento corda <URL dell'endpoint di servizio> Definire un endpoint di servizio univoco
UsaAiutoOnline dword 0 per specificare la Guida locale, 1 per specificare la Guida online Definire l'impostazione predefinita della Guida online o offline
OnlineBaseUrl corda <URL dell'endpoint di servizio> Definire un endpoint F1 univoco
PreferenzaAiutoEnLineaDisabilitata dword 0 per abilitare o 1 disabilitare l'opzione di preferenza della Guida online Disabilitare l'opzione di preferenza della Guida online
DisattivaGestioneContenuti dword 0 per abilitare o 1 disabilitare la scheda Gestisci contenuto in Help Viewer Disabilitare la scheda Gestisci contenuto
DisableFirstRunHelpSelection dword 0 per abilitare o 1 disabilitare le funzionalità della Guida configurate al primo avvio di Visual Studio Disabilitare l'installazione del contenuto al primo avvio di Visual Studio

Per impostare i valori delle chiavi del Registro di sistema in un file con estensione pkgdef, seguire questa procedura:

  1. Creare un nuovo file e assegnargli l'estensione pkgdef.

  2. Aggiungere il testo seguente alla prima riga del file:

    [$RootKey$\Help]

  3. In righe separate aggiungere uno dei valori di chiave del Registro di sistema descritti dalla tabella precedente. Ad esempio, è possibile aggiungere questa riga per configurare il UseOnlineHelp valore:

    "UseOnlineHelp"=dword:00000001

  4. Copiare il file nella cartella CommonExtensions dell'installazione di Visual Studio. Per esempio:

    • Se si usa l'edizione Community di Visual Studio 2017, aggiungere il file con estensione pkgdef alla cartella seguente:

      C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\Common7\IDE\CommonExtensions

    • Se si usa l'edizione Community di Visual Studio 2022, aggiungere il file con estensione pkgdef alla cartella seguente:

      C:\Programmi\Microsoft Visual Studio\2022\Community\Common7\IDE\CommonExtensions

  5. Al prompt dei comandi per gli sviluppatori eseguire questo comando:

    devenv /updateconfiguration

Contenuto del file con estensione pkgdef di esempio

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

Usare l'editor del Registro di sistema per modificare il comportamento di Help Viewer

È possibile controllare i tipi di comportamento seguenti impostando i valori delle chiavi del Registro di sistema nell'editor del Registro di sistema.

Task Chiave del Registro di sistema Value Data
Sostituire la priorità del lavoro BITS HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node (in un sistema a 64-bit)\Microsoft\Help\v2.3 BITSPriority priorità, alto, normale o basso
Indicare l'archivio di contenuti locale sulla condivisione di rete HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Help\ v2.3\Catalogs\VisualStudio15 LocationPath ContentStoreNetworkShare