Condividi tramite

Eseguire l'override delle impostazioni predefinite del Visualizzatore della Guida

  • Articolo

È 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 di Gestione contenuto 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 Type Dati Descrizione
NewContentAndUpdateService string <URL dell'endpoint di servizio> Definire un endpoint di servizio univoco
UseOnlineHelp dword 0 per specificare la Guida locale, 1 per specificare la Guida online Impostare la Guida online o offline come predefinita
OnlineBaseUrl string <URL dell'endpoint di servizio> Definire un endpoint F1 univoco
OnlineHelpPreferenceDisabled dword 0 per abilitare o 1 per disabilitare l'opzione di preferenza della Guida online Disabilitare l'opzione di preferenza della Guida online
DisableManageContent dword 0 per abilitare o 1 per disabilitare la scheda Gestisci contenuto in Help Viewer Disabilitare la scheda Gestisci contenuto
DisableFirstRunHelpSelection dword 0 per abilitare o 1 per 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. Ad esempio:

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

      C:\Programmi (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

Esempio di contenuto del file 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

Uso dell'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.

Attività Chiave del Registro di sistema Valore Dati
Eseguire l'override della priorità del processo BITS HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node (in un computer a 64 bit)\Microsoft\Help\v2.3 BITSPriority foreground, high, normal o low
Puntare all'archivio del contenuto locale nella condivisione di rete HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Help\ v2.3\Catalogs\VisualStudio15 LocationPath ContentStoreNetworkShare

Contenuto correlato