Parametri di contesto per l'avvio delle procedure guidate
I componenti aggiuntivi di Visual Studio sono deprecati in Visual Studio 2013. Si consiglia di effettuare l'aggiornamento dei componenti aggiuntivi alle estensioni di VSPackage. Per ulteriori informazioni sull'aggiornamento, consultare Domande frequenti: conversione di componenti aggiuntivi in VSPackage Extensions.
I parametri di contesto rendono disponibili le informazioni necessarie per l'avvio di una procedura guidata, come il tipo di procedura guidata da utilizzare, il nome del progetto, le directory per gli elementi delle procedure guidate e così via.
Sono disponibili tre tipi diversi di procedure guidate:
NewProject: consente di aggiungere un nuovo progetto a una soluzione.
AddSubProject: consente di aggiungere un sottoprogetto a un progetto esistente.
AddItem: consente di aggiungere un elemento a un progetto esistente.
Tutti e tre i tipi di procedure guidate vengono chiamati tramite il metodo Execute dell'interfaccia IDTWizard. Uno dei parametri necessari del metodo Execute è ContextParams. Per ogni tipo è necessario disporre di un insieme di valori ContextParams diverso nell'ordine corretto, come indicato nella tabella riportata di seguito:
Tipo di procedura guidata |
Parametri utilizzati |
|---|---|
NewProject |
|
AddSubProject |
|
AddItem |
|
Nella tabella riportata di seguito sono elencati tutti i parametri di contesto e le relative descrizioni.
Impostazione |
Descrizione |
|---|---|
WizardType |
Una costante che indica il tipo di procedura guidata, Sono disponibili tre tipi di procedure guidate:
|
ProjectName |
Il nome del progetto. |
ProjectItems |
Puntatore alla raccolta ProjectItems su cui opererà la procedura guidata. Viene passato alla procedura guidata in base alla selezione della gerarchia del progetto. |
LocalDirectory |
Il percorso nel sistema locale in cui si trovano i file del progetto di lavoro della procedura guidata. |
ItemName |
Nome dell'elemento da aggiungere. ItemName è il nome del file che l'utente immette o accetta come predefinito nella finestra di dialogo Aggiungi elemento. A seconda dei flag impostati nel file VSDIR, questa impostazione può essere NULL. |
InstallationDirectory |
Percorso della directory in cui è installato Visual Studio. |
FExclusive |
Un valore booleano che indica se il progetto deve essere esclusivo all'interno della soluzione. Ovvero, se il progetto deve essere aggiunto alla soluzione corrente oppure se la soluzione corrente deve essere chiusa e deve essere creata una nuova soluzione all'interno della quale aggiungere il progetto. |
SolutionName |
Il nome del file della soluzione esclusa la parte della directory o l'estensione sln. Anche il nome del file suo si basa sul nome standard. Se SolutionName contiene un valore, ovvero non si tratta di una stringa vuota, la procedura guidata NewProject chiamerà il metodo Create prima di aggiungere al progetto il metodo AddFromTemplate. Se SolutionName è una stringa vuota, tuttavia, non sarà necessario chiamare il metodo Createprima di chiamare AddFromTemplate. |
Silent |
Valore Boolean che indica se la procedura guidata deve essere eseguita in modo invisibile all'utente, senza che venga visualizzata un'interfaccia utente e accettando tutti i valori predefiniti. Il valore predefinito di Silent è True. |