Supporto per le categorie di impostazioni
Una categoria di impostazioni è costituito da un gruppo di opzioni per la personalizzazione dell'ambiente di sviluppo (IDE) integrato. Ad esempio, le impostazioni possono controllare il layout delle finestre di Visual Studio il contenuto e dei menu. Per ulteriori informazioni, vedere Personalizzazione delle impostazioni di sviluppo in Visual Studio.
Scegliere da Importa/esporta impostazioni del menu di strumenti per avviare Procedura guidata per le impostazioni di importazione ed esportazione. La procedura guidata sono disponibili tre opzioni: esportazione, importazione, o reimpostato le impostazioni. Selezionare l'esportazione, ad esempio, aprire la pagina di scegliere le impostazioni per esportare della procedura guidata.
Il controllo di struttura ad albero nel riquadro di navigazione di questa pagina sono elencate le categorie. Una categoria è un gruppo di impostazioni correlate visualizzati come “un punto di impostazioni personalizzato„, ovvero, ad esempio la casella di controllo. Utilizzare queste caselle di controllo per selezionare le categorie per rendere persistenti in un file di .vsettings. La procedura guidata consente di assegnare al file di .vsettings e specificare il percorso.
Nota
Le impostazioni vengono salvate o ripristinano come categoria e i singoli nomi delle impostazioni non vengono visualizzati nella procedura guidata.
Il framework gestito del pacchetto (MPF) supporta la creazione di categorie di impostazioni con una quantità minima di codice aggiuntivo.
Creare un package VS per fornire un contenitore per la categoria dalla creazione di una sottoclasse la classe di Package .
Creare una categoria stessa derivandola dalla classe di DialogPage .
Per connettere i due con ProvideProfileAttribute.
Supporto per le categorie di impostazioni
La classe di Package fornisce il supporto per la creazione di categorie. la classe di DialogPage implementa una categoria. The default implementation of DialogPage offers its public properties to a user as a category. Per ulteriori informazioni, vedere procedura dettagliata: Creare una categoria di impostazioni.
La classe di DialogPage implementa IProfileManager, che fornisce la persistenza per pagine che le impostazioni utente di opzioni. L'entity_M:Microsoft.VisualStudio.Shell.IProfileManager.LoadSettingsFromXml(Microsoft.VisualStudio.Shell.Interop.IVsSettingsReader) e i metodi di SaveSettingsToXml persistono rispettivamente le impostazioni in un file vssettings che Visual Studio garantisce come IVsSettingsReader o IVsSettingsWriter. Il metodo di ResetSettings reimposta le impostazioni sui valori predefiniti.
La classe di DialogPage fornisce un'implementazione del metodo di LoadSettingsFromXml che legge le coppie nome/valore di feed XML e utilizza la reflection per individuare le proprietà pubbliche nella classe derivata di DialogPage . Le proprietà i cui nomi corrispondono alle coppie nome/valore vengono fornite i valori corrispondenti.
L'implementazione predefinita di SaveSettingsToXml utilizza la reflection per individuare le proprietà pubbliche nella classe derivata di DialogPage e scrive i nomi e valori delle proprietà a XML inseriscono come coppie nome/valore.
Percorso del Registro Di Sistema di categoria di impostazioni
Il percorso del Registro di sistema della categoria di impostazioni è determinato combinando ApplicationRegistryRoot, la parola, UserSettings, la categoria di impostazioni e il nome del punto di impostazioni personalizzato. I nomi del punto di impostazioni di categoria e personalizzate delle impostazioni sono uniti e separati da un carattere di sottolineatura per formare il nome canonico e non localizzato visualizzato nel Registro di sistema. Ad esempio, se la categoria di impostazioni è “my categoria„, il nome personalizzato del punto di impostazioni “impostazioni„ e il \SOFTWARE\Microsoft\VisualStudio\8.0Exp, then the settings category has the registry key, HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\8.0Exp\UserSettings\My Category_My Settings di ApplicationRegistryRoot HKEY_LOCAL_MACHINE.
Nota
Il nome canonico non viene visualizzato in un'interfaccia utente (UI).Viene utilizzato per associare un nome leggibile alla categoria di impostazioni, analogamente a un livello di codice (ProgID).
Attributo di categoria di impostazioni
ProvideProfileAttribute determina il mapping delle categorie ai punti di impostazioni personalizzati in Procedura guidata per le impostazioni di importazione ed esportazione associazione di una categoria con il package VS che la rappresenta. Si consideri il frammento di codice riportato di seguito.
<ProvideProfile(GetType(OptionsPageGeneral), "My Category", "My Settings", 106, 107, True, DescriptionResourceID:=108),
Guid("B0002DC2-56EE-4931-93F7-70D6E9863940")>
Public Class MyPackage
Inherits Package
[ProvideProfile(typeof(OptionsPageGeneral),"My Category", "My Settings", 106, 107, true, DescriptionResourceID = 108)]
[Guid("B0002DC2-56EE-4931-93F7-70D6E9863940")]
public class MyPackage : Package
ID di risorsa 106 mapping “nella categoria„, 107 “a mie impostazioni„ e “108 " varie opzioni„. Ciò indica che MyPackage fornisce la categoria, impostazioni di Category_My. La categoria viene fornita dalla classe di OptionsPageGeneral , che deve implementare IProfileManager. Le impostazioni di quella categoria sono le proprietà pubbliche della classe di OptionsPageGeneral .
In Procedura guidata per le impostazioni di importazione ed esportazione, il passaggio di impostazioni ha un nome, impostazioni. Quando il punto di impostazioni è selezionato, la descrizione, varie opzioni, viene visualizzato. Il nome e la descrizione del punto di impostazioni derivano dalle risorse di tipo stringa localizzata.
Vedere anche
Attività
procedura dettagliata: creare una pagina di opzioni
Concetti
Esempi di estensibilità di Visual Studio
Personalizzazione delle impostazioni di sviluppo in Visual Studio