Creare una categoria di impostazioni

Articolo
12/21/2023

In questa procedura dettagliata viene creata una categoria di impostazioni di Visual Studio e usata per salvare e ripristinare i valori da un file di impostazioni. Una categoria di impostazioni è un gruppo di proprietà correlate che vengono visualizzate come "punto di impostazioni personalizzate"; ovvero, come casella di controllo nella procedura guidata Importa ed Esporta Impostazioni. (È possibile trovarlo sul Menu Strumenti.) Impostazioni vengono salvati o ripristinati come categoria e le singole impostazioni non vengono visualizzate nella procedura guidata. Per altre informazioni, vedere Impostazioni dell'ambiente.

Creare una categoria di impostazioni derivandola dalla DialogPage classe .

Per iniziare questa procedura dettagliata, è necessario prima completare la prima sezione della pagina Crea un'opzione. La griglia delle proprietà Options risultante consente di esaminare e modificare le proprietà nella categoria. Dopo aver salvato la categoria di proprietà in un file di impostazioni, esaminare il file per verificare la modalità di archiviazione dei valori delle proprietà.

Creare una categoria di impostazioni

In questa sezione si usa un punto di impostazioni personalizzate per salvare e ripristinare i valori della categoria delle impostazioni.

Per creare una categoria di impostazioni

Completare la pagina Crea un'opzione.
Aprire il file VSPackage.resx e aggiungere queste tre risorse stringa:

Nome valore

106 Categoria personale

107 Impostazioni personali

108 OptionInteger e OptionFloat

In questo modo vengono create risorse che denominano la categoria "My Category", l'oggetto "My Impostazioni" e la descrizione della categoria "OptionInteger e OptionFloat".

Nota

Di questi tre, solo il nome della categoria non viene visualizzato nella procedura guidata Importa ed Esporta Impostazioni.

In MyToolsOptionsPackage.cs aggiungere una float proprietà denominata OptionFloat alla OptionPageGrid classe , come illustrato nell'esempio seguente.

public class OptionPageGrid : DialogPage
{
    private int optionInt = 256;
    private float optionFloat = 3.14F;

    [Category("My Options")]
    [DisplayName("My Integer option")]
    [Description("My integer option")]
    public int OptionInteger
    {
        get { return optionInt; }
        set { optionInt = value; }
    }
    [Category("My Options")]
    [DisplayName("My Float option")]
    [Description("My float option")]
    public float OptionFloat
    {
        get { return optionFloat; }
        set { optionFloat = value; }
    }
}

Nota

La OptionPageGrid categoria denominata "My Category" è ora costituita dalle due proprietà e OptionInteger OptionFloat.

Aggiungere un oggetto ProvideProfileAttribute alla MyToolsOptionsPackage classe e assegnargli categoryname "My Category", assegnargli il valore ObjectName "My Impostazioni" e impostare isToolsOptionPage su true. Impostare categoryResourceID, objectNameResourceID e DescriptionResourceID sui corrispondenti ID risorsa stringa creati in precedenza.
```
[ProvideProfileAttribute(typeof(OptionPageGrid),
    "My Category", "My Settings", 106, 107, isToolsOptionPage:true, DescriptionResourceID = 108)]
```
Compilare il progetto e avviare il debug. Nell'istanza sperimentale si noterà che la pagina Griglia personale ora ha valori integer e float.

Esaminare il file di impostazioni

In questa sezione si esportano i valori delle categorie di proprietà in un file di impostazioni. Esaminare il file e quindi importare nuovamente i valori nella categoria di proprietà.

Avviare il progetto in modalità di debug premendo F5. Verrà avviata l'istanza sperimentale.
Aprire la finestra di dialogo Opzioni strumenti>.
Nella visualizzazione albero nel riquadro sinistro espandere My Category (Categoria personale) e quindi fare clic su My Grid Page (Pagina griglia personale).
Impostare il valore di OptionFloat su 3.1416 e OptionInteger su 12. Fare clic su OK.
Scegliere Importa/Esporta impostazioni dal menu Strumenti.

Verrà visualizzata la procedura guidata Importa ed Esporta Impostazioni.
Assicurarsi che l'opzione Esporta impostazioni di ambiente selezionate sia selezionata e quindi fare clic su Avanti.

Viene visualizzata la pagina Scegli Impostazioni da esportare.
Fare clic su Impostazioni personale.

La descrizione viene modificata in OptionInteger e OptionFloat.
Assicurarsi che My Impostazioni sia l'unica categoria selezionata e quindi fare clic su Avanti.

Verrà visualizzata la pagina Nome file Impostazioni.
Denominare il nuovo file di impostazioni My Impostazioni.vssettings e salvarlo in una directory appropriata. Fare clic su Fine.

Il .vssettings file è il file delle impostazioni di Visual Studio. Lo schema del file è aperto. Più comunemente, lo schema segue una struttura XML in cui ogni categoria è un tag, che può contenere tag di sottocategoria. Questi tag di sottocategoria possono contenere tag di valore della proprietà. Sebbene la maggior parte dei pacchetti usi la struttura comune, qualsiasi pacchetto in Visual Studio può contribuire a xml arbitrario al file con lo schema scelto.

La pagina Esporta completata segnala che le impostazioni sono state esportate correttamente.
Scegliere Apri dal menu Filee quindi fare clic su File. Individuare My Impostazioni.vssettings e aprirlo.

È possibile trovare la categoria di proprietà esportata nella sezione seguente del file (i GUID saranno 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="MyToolsOptionsPackage">
   <PropertyValue name="OptionFloat">3.1416</PropertyValue>
   <PropertyValue name="OptionInteger">12</PropertyValue>
</Category>
```
Si noti che il nome completo della categoria è formato dall'aggiunta di un carattere di sottolineatura al nome della categoria seguito dal nome dell'oggetto. OptionFloat e OptionInteger vengono visualizzati nella categoria, insieme ai valori esportati.
Chiudere il file di impostazioni senza modificarlo.
Nel menu Strumenti fare clic su Opzioni, espandere Categoria personale, fare clic su Pagina Griglia personale e quindi modificare il valore di OptionFloat su 1.0 e OptionInteger su 1. Fare clic su OK.
Nel menu Strumenti fare clic su Importa ed Esporta Impostazioni, selezionare Importa impostazioni di ambiente selezionate e quindi fare clic su Avanti.

Viene visualizzata la pagina Salva Impostazioni corrente.
Selezionare No, importare solo nuove impostazioni e quindi fare clic su Avanti.

Viene visualizzata la pagina Choose a Collection of Impostazioni to Import (Scegli una raccolta di Impostazioni da importare).
Selezionare il file My Impostazioni.vssettings nel nodo My Impostazioni della visualizzazione albero. Se il file non viene visualizzato nella visualizzazione albero, fare clic su Sfoglia e trovarlo. Fare clic su Avanti.

Viene visualizzata la finestra di dialogo Scegli Impostazioni da importare.
Assicurarsi che l'opzione My Impostazioni (My Impostazioni) sia selezionata e quindi fare clic su Fine. Quando viene visualizzata la pagina Importa completamento , fare clic su Chiudi.
Scegliere Opzioni dal menu Strumenti, espandere Categoria personale, fare clic su Pagina Griglia personale e verificare che i valori delle categorie di proprietà siano stati ripristinati.