Rendere persistenti le impostazioni
Un VSPackage possibile definire una o più categorie di impostazioni, ovvero gruppi di variabili dello stato che vengono conservate quando un utente sceglie il comando di Impostazioni esportazione/importazione scegliere dal menu di strumenti . Per attivare la persistenza, utilizzare le API in Visual Studio SDK.
Una voce del Registro di sistema che è indicata come un punto di impostazioni personalizzato e un GUID definisce la categoria di impostazioni di un VSPackage. Un VSPackage può supportare più più categorie di impostazioni, ognuna definita da un punto di impostazioni personalizzato.
Le implementazioni delle impostazioni basate degli assembly di interoperabilità mediante l'interfaccia di IVsUserSettings ) devono creare il punto di impostazioni personalizzato modificando il Registro di sistema o utilizzando uno script di registrazione (file RGS). Per ulteriori informazioni, vedere Creazione di script di registrazione.
Il codice che utilizza il pacchetto gestito Framework (MPF) necessario creare i punti di impostazioni personalizzati con ProvideProfileAttribute al package VS per ogni passaggio di impostazioni personalizzato.
Se un singolo pacchetto VS supporta diversi punti di impostazioni personalizzati, ogni punto di impostazioni personalizzato viene implementata da una classe separata e ognuno viene registrato da un'istanza univoca della classe di ProvideProfileAttribute . Di conseguenza, le impostazioni che implementano la classe può supportare più categorie di impostazioni.
Dettagli personalizzati della voce del Registro di sistema del punto di impostazioni
I punti di impostazioni personalizzati vengono creati in una voce del Registro di sistema nel percorso seguente: \Software\Microsoft\VisualStudio HKLM \ <versione> \UserSettings \<CSPName>, dove <CSPName> è il nome delle impostazioni personalizzate dai contenuti multimediali e <versione> di un VSPackage sono la versione di Visual Studio, ad esempio 8,0.
Nota
Il percorso radice HKEY_LOCAL_MACHINE \SOFTWARE\Microsoft\VisualStudio \ <versione> è possibile eseguire l'override con alternanza la radice quando l'ambiente di sviluppo integrato di Visual Studio (IDE) viene inizializzato.Per ulteriori informazioni, vedere Opzioni della riga di comando (Visual Studio SDK).
La struttura della voce del Registro di sistema è illustrata di seguito:
\Software\Microsoft\VisualStudio HKLM \ <versione> \UserSettings \
<CSPName>= s “#12345„
pacchetto = “{}„
Categoria = “{AAAA YYYYYYYYY yyyy yyyy di YYYYYY}„
ResourcePackage = “{ZZZZZZ ZZZZ ZZZZ ZZZZ ZZZZZZZZZ}„
AlternateParent = CategoryName
Nome |
Type |
Dati |
Descrizione |
|---|---|---|---|
(Valore predefinito) |
REG_SZ |
Nome del punto di impostazioni personalizzato |
The key's name, <CSPName>, is the unlocalized name of the Custom Settings Point. Per le implementazioni basate su MPF, il nome della chiave è ottenuto combinando gli argomenti di objectName e di categoryName del costruttore di ProvideProfileAttribute in categoryName_objectName. La chiave può essere vuota, oppure può contenere il riferimento ID alla stringa localizzata in una DLL satellite. Questo valore viene ottenuto dall'argomento di objectNameResourceID al costruttore di ProvideProfileAttribute . |
Pacchetto |
REG_SZ |
GUID |
Il GUID del pacchetto VS che implementa il punto di impostazioni personalizzato. Le implementazioni basate su MPF utilizzando ProvideProfileAttribute classe, utilizzare l'argomento di objectType del costruttore che contiene Type e reflection del package VS per ottenere questo valore. |
Categoria |
REG_SZ |
GUID |
GUID che identifica la categoria di impostazioni. For implementations based on interop assemblies, this value can be an arbitrarily chosen GUID, which the Visual Studio IDE passes to the ExportSettings and the ImportSettings methods. Tutte le implementazioni di questi due metodi devono verificare i relativi argomenti di GUID. Per le implementazioni basate su MPF, il GUID è ottenuto da Type della classe che implementa il meccanismo delle impostazioni di Visual Studio . |
ResourcePackage |
REG_SZ |
GUID |
Parametro facoltativo. Percorso della DLL satellite contenente stringhe localizzate se il package VS di implementazione non ne garantisce. MPF utilizza la reflection per ottenere la risorsa corretta package VS, in modo dalla classe di ProvideProfileAttribute non imposta questo argomento. |
AlternateParent |
REG_SZ |
Nome della cartella nella pagina delle Opzioni degli Strumenti che contiene il punto di impostazioni personalizzato. |
Parametro facoltativo. È necessario impostare tale valore solo se l'implementazione di impostazioni supporta le pagine di Opzioni degli strumenti che utilizzano il meccanismo di persistenza in Visual Studio SDK anziché il meccanismo nel modello di automazione di salvare lo stato. Per ulteriori informazioni, vedere Per registrare pagine personalizzate di opzioni. In questi casi, il valore nella chiave di AlternateParent è la sezione di topic della stringa di topic.sub-topic utilizzata per identificare la pagina di strumentiopzioni di particolare. Ad esempio, per la pagina "TextEditor.Basic" di strumentiopzioni il valore di AlternateParent sarebbe"TextEditor". Quando ProvideProfileAttribute generato il punto di impostazioni personalizzato, è uguale al nome della categoria. |
Vedere anche
Attività
Procedura: Esporta impostazioni tramite assembly di interoperabilità
Procedura: Assembly di interoperabilità viene utilizzato per importare le impostazioni
Riferimenti
Creazione di script di registrazione
Creazione di script di registrazione
Concetti
Utilizzando le pagine di opzioni
Rendere persistenti le impostazioni