Condividi tramite

procedura dettagliata: Creare una categoria di impostazioni

  • Articolo

In questa procedura dettagliata, è possibile creare una categoria di impostazioni di Visual Studio e utilizzarlo per salvare i valori e per ripristinare i valori da un file di impostazioni. Una categoria è un gruppo di proprietà correlate visualizzati come “un punto di impostazioni personalizzato„; ovvero la casella di controllo nella procedura guidata per le impostazioni di importazione ed esportazione. Per avviare la procedura guidata, scegliere dal menu di strumenti , fare clic su Impostazioni di esportazione e importazione. Le impostazioni vengono salvate o ripristinano come categoria e delle singole impostazioni non viene visualizzata nella procedura guidata. Per ulteriori informazioni, vedere Personalizzazione delle impostazioni di sviluppo in Visual Studio.

Il framework gestito del pacchetto (MPF) supporta la creazione di categorie di impostazioni con il codice aggiuntivo irrilevante. 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 .

Nota

Sebbene DialogPage possibile fornire un'interfaccia utente della griglia o personalizzate della proprietà (UI), non viene utilizzato da gestione impostazioni.

Per iniziare questa procedura dettagliata, è necessario completare innanzitutto la prima sezione di procedura dettagliata: creare una pagina di opzioni. La griglia risultante di proprietà di opzioni consente di esaminare e modificare le proprietà nella categoria. Dopo avere salvato la categoria della proprietà in un file di impostazioni, esaminare il file per vedere come i valori della proprietà vengono archiviati.

Prerequisiti

Per completare questa procedura dettagliata, è necessario installare Visual Studio 2010 SDK.

Nota

per ulteriori informazioni su Visual Studio SDK, vedere Cenni preliminari sull'estensione di Visual Studio.Per ulteriori informazioni su come scaricare Visual Studio SDK, vedere Centro per sviluppatori di estensibilità di Visual Studio il sito Web MSDN.

Posizioni del modello di progetto del pacchetto Visual Studio

Il modello di progetto del pacchetto Visual Studio è disponibile in tre posizioni diverse nella finestra di dialogo di nuovo progetto :

  1. Sotto di estensibilità di Visual Basic. La lingua predefinita del progetto di Visual Basic.

  2. Sotto di estensibilità di c#. La lingua predefinita del progetto è c#.

  3. Nell'ambito dell'altra estensibilità dei tipi di progetto. La lingua predefinita del progetto è C++.

Creare una categoria di impostazioni

In questa sezione, si crea una categoria di impostazioni tramite il modello di progetto importa pacchetto di Visual Studio. Utilizzare un punto di impostazioni personalizzato per salvare e ripristinare i valori della categoria di impostazioni.

Per creare una categoria di impostazioni

  1. completare la prima sezione di procedura dettagliata: creare una pagina di opzioni.

  2. Fare clic con il pulsante destro del mouse sul nodo del progetto di MyToolsOptions quindi fare clic su set come progetto di avvio.

  3. Aprire il file di VSPackage.resx e aggiungere queste tre risorse di tipo stringa:

    Nome

    Valore

    106

    Con La categoria

    107

    Impostazioni

    108

    OptionInteger e OptionFloat

    Ciò crea le risorse che consentono di denominare la categoria “my categoria„, l'oggetto “impostazioni„ e la descrizione “OptionInteger e OptionFloat„ categories.

    Nota

    Di questi tre, solo il nome della categoria non è presente nella procedura guidata per le impostazioni di importazione ed esportazione.

  4. Aprire il file MyToolsOptionsPackage.cs o MyToolsOptionsPackage.vb nel progetto MyToolsOptions e aggiungere una proprietà di float denominata OptionFloat alla classe di OptionPageGrid , come illustrato nell'esempio seguente.

    Public Class OptionPageGrid
    Inherits DialogPage
    Private _optionInt As Integer = 256
    Private _optionFloat As Single = 3.14F

    <Category("My Options")>
    <Description("My integer option")>
    Public Property OptionInteger() As Integer 
        Get 
            Return _optionInt
        End Get 
        Set(ByVal value As Integer)
            _optionInt = value
        End Set 
    End Property
    <Category("My Options")>
    <Description("My float option")>
    Public Property OptionFloat() As Single 
        Get 
            Return _optionFloat
        End Get 
        Set(ByVal value As Single)
            _optionFloat = value
        End Set 
    End Property 
End Class

    public class OptionPageGrid : DialogPage
{
    private int _optionInt = 256;
    private float _optionFloat = 3.14F;

    [Category("My Options")]
    [Description("My integer option")]
    public int OptionInteger
    {
        get { return _optionInt; }
        set { _optionInt = value; }
    }
    [Category("My Options")]
    [Description("My float option")]
    public float OptionFloat
    {
        get { return _optionFloat; }
        set { _optionFloat = value; }
    }
}

    Nota

    La categoria di OptionPageGrid denominata “my categoria„ ora è costituito da due proprietà, di OptionInteger e di OptionFloat.

  5. Aggiungere ProvideProfileAttribute alla classe di MyToolsOptions e assegnarle il CategoryName “my categoria„, assegnargli il ObjectName “impostazioni„ e il set IsToolsOptionPage a true. imposta il categoryResourceID, il objectNameResourceID e il DescriptionResourceID sulla risorsa di tipo stringa corrispondente ID creata in precedenza.

    <ProvideProfileAttribute(GetType(OptionPageGrid), "My Category", "My Settings", 106, 107, True, DescriptionResourceID:=108)>
<Guid(GuidList.guidMyToolsOptionsPkgString)>
Public NotInheritable Class MyToolsOptions
    Inherits Package

    [ProvideProfileAttribute(
   typeof(OptionPageGrid), "My Category", "My Settings",
   106, 107, true, DescriptionResourceID = 108)]
[Guid(GuidList.guidMyToolsOptionsPkgString)]
public sealed class MyToolsOptions : Package

  6. Compilare il progetto e verificare che venga compilato senza errori.

Revisione del Registro di sistema

In questa sezione, si esamina le voci del Registro di sistema apportate da ProvideProfileAttribute.

Per esaminare il Registro di sistema

  1. Avviare Visual Studio in modalità sicura.

    Verrà avviata Visual Studio Esp e scrive gli argomenti di ProvideProfileAttribute al Registro di sistema.

    Nota

    due versioni di Visual Studio ora sono aperte.

  2. chiudere l'istanza di debug di Visual Studio.

  3. Eseguire l'editor del Registro di sistema e analizzare la voce del Registro di sistema per HKCU \Software\Microsoft\VisualStudio\10.0Exp_Config\UserSettings\MyCategory_MySettings. Nella tabella seguente sono illustrate le sottochiavi della voce (i GUID risulteranno diversi).

    Nome

    Dati

    (Valore predefinito)

    #107

    Categoria

    {} ba1e23e3-fecc-425d-8259-06c40cfac1b6

    Descrizione

    #108

    Pacchetto

    {} a2192704-7d66-44b7-b61b-44ed96aace98

    Il valore predefinito “#107„ della sottochiave fa riferimento alla risorsa di tipo stringa “impostazioni„. Il valore “#108„ della sottochiave di descrizione fa riferimento alla risorsa di tipo stringa “OptionInteger e OptionFloat„.

Correzione del Registro di sistema

In questa sezione, correzione le voci del Registro di sistema apportate da ProvideProfileAttribute.

ProvideProfileAttribute è progettato per scrivere la risorsa ID per le risorse non gestite nel Registro di sistema. Il caricatore di risorse di Visual Studio che la risorsa non gestita ID per far precedere i valori numerici da “#„ e le risorse gestite devono presentare valori numerici senza anteporre “#„. Pertanto, è necessario eliminare “#„ della risorsa gestita ID.

Per correggere il Registro di sistema

  1. Correggere la voce del Registro di sistema HKLM \Software\Microsoft\VisualStudio\8.0Exp\UserSettings\MyCategory_MySettings eliminando “#„ dalle sottochiavi numeriche. Nella tabella seguente sono illustrate le sottochiavi della voce (i GUID risulteranno diversi).

    Nome

    Dati

    (Valore predefinito)

    107

    Categoria

    {} ba1e23e3-fecc-425d-8259-06c40cfac1b6

    Descrizione

    108

    Pacchetto

    {} a2192704-7d66-44b7-b61b-44ed96aace98

    ToolsOptionsPath

    Con La categoria

  2. Fare clic con il pulsante destro del mouse sulla voce del Registro di sistema ed esportarla nel file “settings.reg„ nella cartella del progetto di MyToolsOptions.

  3. Chiudere l'Editor del Registro di sistema.

  4. Fare clic con il pulsante destro del mouse sul nodo del progetto di MyToolsOptions e aggiungere “settings.reg„ al progetto.

  5. Aprire VsPkg.cs o VsPkg.vb e impostare come commento ProvideProfileAttribute e gli argomenti.

    '<ProvideProfileAttribute(GetType(OptionPageGrid), "My Category", "My Settings", 106, 107, True, DescriptionResourceID := 108)>

    //[ProvideProfileAttribute( 
//   typeof(OptionPageGrid), "My Category", "My Settings", 
//   106, 107, true, DescriptionResourceID = 108)]

    Ciò impedisce corrette voci del Registro di sistema da essere riscritto nel Registro di sistema.

  6. Fare clic con il pulsante destro del mouse sul progetto MyToolsOptions quindi fare clic su Proprietà.

    Fare clic sulla scheda di eventi di compilazione e aggiungere seguente Riga di comando eventi post-compilazione. È necessario includere il percorso completo del file di settings.reg (il percorso può essere diverso).

    regedit /s D:\MyToolsOptions\MyToolsOptions\settings.reg

  7. Compilare la soluzione di MyToolsOptions. Le sottochiavi numeriche corrette verranno scritte nel Registro di sistema.

    Nota

    È inoltre necessario apportare le correzioni quando si crea un file di Registro per la distribuzione finale di un VSPackage.

Esame del file di impostazioni

In questa sezione, esportare i valori di categoria della proprietà a un file di impostazioni. Esaminare il file e quindi importare i valori nella categoria della proprietà.

Per esaminare il file di impostazioni

  1. Avviare Visual Studio in modalità sicura. Verrà avviata Visual Studio Esp.

    Nota

    due versioni di Visual Studio ora sono aperte.

  2. In Visual Studio Esp, scegliere dal menu di strumenti , fare clic suopzioni.

    Verrà visualizzata la finestra di dialogo Opzioni.

  3. Nella visualizzazione struttura ad albero nel riquadro sinistro, espandere Con La categoria quindi fare clic su Con La pagina della griglia.

    La griglia di opzioni viene visualizzato nel riquadro di destra. The property category is My Options, and the property names are OptionFloat and OptionInteger.

  4. Modificare il valore di OptionFloat e su 3,1416 OptionInteger a 12. Scegliere OK.

  5. Scegliere Importa/Esporta impostazioni dal menu Strumenti.

    La procedura guidata di Importare ed esportare le impostazioni viene visualizzato.

  6. Assicurarsi che impostazioni di ambiente selezionate esportazione sia selezionato e quindi scegliere dopo.

    La pagina di scegliere le impostazioni per esportare viene visualizzata.

  7. Scegliere Impostazioni.

    Le modifiche di descrizione a OptionInteger e OptionFloat.

  8. Assicurarsi che Impostazioni sia selezionato e quindi fare clic dopo.

    La pagina di denominare il file di impostazioni viene visualizzata.

  9. Assegnare al nuovo file di impostazioni MySettings.vssettings e salvarlo in una directory appropriata. Fare clic su Fine.

    La pagina di esportare completo segnala che le impostazioni di sono state esportate.

  10. Nel menu File selezionare Apri, quindi File. individuare MySettings.vssettings e aprirlo.

    È possibile trovare la categoria che la proprietà è stato esportato nella seguente sezione del file (i GUID risulteranno diversi).

    <Category name="My Category_My Settings" 
      Category="{4802bc3e-3d9d-4591-8201-23d1a05216a6}" 
      Package="{6bb6942e-014c-489e-a612-a935680f703d}" 
      RegisteredName="My Category_My Settings">
      PackageName="Company.MyToolsOptions.MyToolsOptions,          MyToolsOptions, Version=1.0.2251.20398, Culture=neutral,          PublicKeyToken=d74639816260e962">
   <PropertyValue name="OptionFloat">3.1416</PropertyValue> 
   <PropertyValue name="OptionInteger">12</PropertyValue> 
</Category>

    Si noti che il nome della categoria completo è formato collegando aggiungendo un carattere di sottolineatura al nome della categoria seguito dal nome dell'oggetto. OptionFloat e OptionInteger vengono visualizzate nella categoria, insieme ai relativi valori esportati.

  11. chiudere il file di impostazioni senza modificarlo.

  12. Scegliere dal menu di strumenti , fare clic su opzioni, espandere Con La categoria, fare clic su Con La pagina della griglia e quindi modificare i valori di OptionFloat e di OptionInteger. Scegliere OK.

  13. Scegliere dal menu di strumenti , fare clic su Importa/esporta impostazioni, impostazioni di ambiente selezionate importazionequindi fare clic su dopo.

    La pagina di salvare le impostazioni correnti viene visualizzata.

  14. No, include solo le nuove impostazioni quindi fare clic su dopo.

    La pagina di Scegliere una raccolta di impostazioni per importare viene visualizzata.

  15. Selezionare il file di MySettings.vssettings nel nodo di Impostazioni della visualizzazione struttura ad albero. Se il file non viene visualizzato nella visualizzazione struttura ad albero, fare clic su Navigazione e risultare. Scegliere Avanti.

    La finestra di dialogo di Scegliere le impostazioni per importare viene visualizzato.

  16. Assicurarsi che Impostazioni sia selezionato e quindi fare clic - Fine. Quando la pagina di Importazione viene completata viene visualizzata, scegliere Chiudi.

  17. Scegliere dal menu di strumenti , fare clic opzioni, espandere Con La categoria, fare clic sulla funzionalità Pagina della griglia e verificare che i valori di categoria di proprietà siano stati ripristinati.

Vedere anche

Concetti

Supporto per le categorie di impostazioni

Altre risorse

Stato di un VSPackage