Aggiunta di procedure guidate alle finestre di dialogo Aggiungi elemento e Nuovo progetto tramite file vsdir

  • Articolo

Un file VSDir è un file di testo con estensione vsdir che viene creato per fornire informazioni su come visualizzare i relativi elementi nelle finestre di dialogo Aggiungi elemento e Nuovo progetto. Le informazioni includono i nomi di elementi, l'ordine in cui devono essere visualizzati e l'icona visualizzata con essi. Queste informazioni possono essere modificate. I file VSDir consentono di aggiungere nuovi modelli o procedure guidate alle finestre di dialogo Aggiungi elemento e Nuovo progetto.

Non è presente alcun file VSDir predefinito. Se ne è presente uno, verrà letto in Visual Studio e il relativo contenuto verrà aggiunto alle finestre di dialogo. Se non ne è presente uno, verranno visualizzati modelli e procedure guidate predefiniti. Possono essere presenti più file VSDir in un'unica directory e il loro contenuto verrà aggiunto alle finestre di dialogo. In genere, un file VSDir contiene record per più procedure guidate, cartelle e modelli. Ogni record del file è separato da un carattere di nuova riga. I caratteri Pipe (|) separano i campi in ciascun record. Qualsiasi campo facoltativo per cui non sono disponibili dati significativi contiene uno zero (0) o uno spazio come segnaposto. Le stringhe immesse nei campi non devono essere racchiuse tra virgolette.

Componenti del file VSDir

Di seguito sono riportati file VSDir di esempio. Il primo fa riferimento a una procedura guidata creata nell'argomento Procedura dettagliata: creazione di una procedura guidata:

MyNewWizard.vsz| |A New Wizard|1|My New Wizard|C:\Addins\MyNewWizard\MyNewWizard\bin\Debug| | |MyNewWizard99

Il file VSDir di esempio successivo fa riferimento a vari file vsz di procedura guidata, insieme ad altre informazioni pertinenti relative a ogni procedura guidata, come illustrato in seguito in questo argomento. Si tratta di file diversi dal file VSDir precedente poiché fanno riferimento a stringhe come numeri ID di risorsa, non a stringhe letterali. Inoltre, utilizzano GUID per fare riferimento a DLL.

..\..\Projects\csharp building blocks\BusinessFacade.vsz|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|#5015|10|#5022|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|127|0|Project
..\..\Projects\csharp building blocks\BusinessRules.vsz|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|#5016|20|#5023|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|128|0|Project
..\..\Projects\csharp building blocks\DataAccess.vsz|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|#5017|30|#5024|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|129|0|Project
..\..\Projects\csharp building blocks\SystemFrameworks.vsz|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|#5018|40|#5025|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|130|0|Project
..\..\Projects\csharp building blocks\WebService.vsz|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|#5019|50|#5026|{FAE04EC1-301F-11d3-BF4B-00C04F79EFBC}|4547|1|WebService|Web
..\..\Projects\csharp building blocks\WebUI.vsz|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|#5020|60|#5027|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|131|1|WebUI|web
..\..\Projects\csharp building blocks\WinUI.vsz|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|#5021|70|#5028|{AE77B8D0-6BDC-11d2-B354-0000F81F0C06}|132|0|Project

I seguenti campi possono essere specificati per ogni record in un file VSDir:

Campo

Significato

RelPathName

Parametro obbligatorio. Nome del file vsz della procedura guidata, ad esempio MyWizard.vsz, relativo alla directory di installazione di Visual Studio.

{clsidPackage}

Facoltativo. GUID che rappresenta un prodotto, ad esempio Visual C++, che dispone di una DLL contenente risorse localizzate. In genere, questo campo è vuoto per i file VSDir che corrispondono a procedure guidate di terze parti.

LocalizedName

Facoltativo. Nome localizzabile della procedura guidata o del modello e nome che viene visualizzato nella finestra di dialogo Aggiungi elemento. Può trattarsi di una stringa o di un identificatore di risorsa nella forma #ResID.

SortPriority

Obbligatorio. Intero che rappresenta l'ordinamento e la priorità relativa della procedura guidata, dove 1 è il valore più alto. Ad esempio, se questo elemento vale 1, esso apparirà accanto agli altri elementi con valore 1 e sopra agli elementi con valore maggiore o uguale a 2.

Description

Obbligatorio. Descrizione localizzabile del modello o della procedura guidata che verrà visualizzata nella finestra di dialogo Aggiungi elemento quando l'elemento verrà selezionato. Può trattarsi di una stringa o di un identificatore di risorsa nella forma #ResID. Si applica solo ai file modello, non alle cartelle.

DLLPath o {clsidPackage}

Obbligatorio. Specifica un percorso completo di un file dll o exe o un GUID di un prodotto che dispone di un file dll contenente un'icona da caricare per la procedura guidata. L'icona viene caricata come risorsa da un file dll/exe utilizzando il valore IconResourceId dato. Questa impostazione esegue l'override di {clsidPackage}, se specificato, per la posizione dell'icona. Si applica solo ai file modello, non alle cartelle.

IconResourceId

Facoltativo. Un identificatore di risorsa all'interno del file DLL che determina l'icona da visualizzare. Se non viene definita alcuna icona, l'ambiente utilizzerà l'icona predefinita per un file con la stessa estensione dell'elemento. Si applica solo ai file modello, non alle cartelle.

Flag

Facoltativo. Vedere di seguito la descrizione Flags e la tabella. Si applica solo ai file modello, non alle cartelle.

SuggestedBaseName

Obbligatorio. Nome predefinito per la procedura guidata che viene visualizzato nel campo Nome della finestra di dialogo. Può trattarsi di una stringa o di un identificatore di risorsa nella forma #ResID. Se il nome non è univoco, l'ambiente vi aggiunge un numero intero. Ad esempio, MyFile.aspx potrebbe essere modificato in MyFile1.aspx. Se non viene fornito alcun nome, viene utilizzato "Progetto". Si applica solo ai file modello, non alle cartelle.

  • Notes
    Qualsiasi campo facoltativo in cui non vi sono dati significativi dovrebbe contenere uno zero (0) come segnaposto.

    Se non viene fornito alcun nome localizzato, viene utilizzato il percorso relativo.

    Se non è definita alcuna icona, l'IDE sostituisce i file con l'estensione indicata con l'icona predefinita.

    Se non viene fornito alcun nome di base, viene utilizzato "Progetto".

  • Flag
    Gruppo di flag bit per bit utilizzati per attivare o disabilitare i campi Nome e Percorso della finestra di dialogo Aggiungi elemento. In questo modo, quando si sceglie Aggiungi nuovo elemento dal menu Aggiungi, il progetto consente di determinare se il nome e il percorso vengono visualizzati nella schermata Modelli ma i flag determinano se il nome e il percorso sono disponibili per l'utente.

    Impostare il valore di Flags sulla somma dei singoli valori. 33 equivale, ad esempio, a VSDIRFLAG_NonLocalTemplate | VSDIRITEM_DisableLocationField.

    Nome del flag

    Valore decimale

    Descrizione

    VSDIRFLAG_NonLocalTemplate

    1

    Utilizzo dei meccanismi di comportamento e di salvataggio dell'interfaccia utente non locale.

    VSDIRFLAG_BlankSolution

    2

    Creazione di una soluzione vuota, non di un progetto.

    VSDIRFLAG_DisableBrowseButton

    4

    Disabilitazione del pulsante Sfoglia per questo progetto o elemento.

    VSDIRFLAG_DontAddDefExtension

    8

    Richiesta di non aggiungere un'estensione predefinita al nome fornito per l'elemento. Questa impostazione non è valida per i progetti.

    VSDIRFLAG_DisableLocationField

    32

    Disabilitazione del campo del percorso per questo progetto o elemento.

    VSDIRFLAG_DontInitNameField

    4096

    Non inizializzazione del campo del nome per questo progetto o elemento con nome valido.

    VSDIRFLAG_DisableNameField

    8192

    Disabilitazione del campo Nome per questo progetto o elemento.

Vedere anche

Attività

Procedura: creare un componente aggiuntivo

Procedura dettagliata: creazione di una procedura guidata

Concetti

Progettazione di una procedura guidata

Configurazione di file vsz per l'avvio di procedure guidate

Altre risorse

Creazione di componenti aggiuntivi e di procedure guidate