Metodo _DTE.LaunchWizard

Articolo
08/11/2011

Esegue una procedura guidata con i parametri specificati.

Spazio dei nomi: EnvDTE
Assembly: EnvDTE (in EnvDTE.dll)

Sintassi

'Dichiarazione
Function LaunchWizard ( _
    VSZFile As String, _
    ByRef ContextParams As Object() _
) As wizardResult

wizardResult LaunchWizard(
    string VSZFile,
    ref Object[] ContextParams
)

wizardResult LaunchWizard(
    [InAttribute] String^ VSZFile, 
    [InAttribute] array<Object^>^% ContextParams
)

abstract LaunchWizard : 
        VSZFile:string * 
        ContextParams:Object[] byref -> wizardResult

function LaunchWizard(
    VSZFile : String, 
    ContextParams : Object[]
) : wizardResult

Parametri

VSZFile
Tipo: System.String
Obbligatorio.Il file VSZ (procedura guidata) che contiene le informazioni necessarie per avviare la procedura guidata.

ContextParams
Tipo: array<System.Object[]%
Obbligatorio.I parametri per la procedura guidata.Il primo parametro è un GUID che identifica il contesto di avvio in modo univoco distinguendolo da Add Item o Add Project oppure da un GUID personalizzato.I restanti argomenti sono definiti dall'utente e i rispettivi numeri e valori dipendono dalla procedura guidata.
Le procedure guidate o i modelli inclusi in Visual Studio, come ad esempio le applicazioni per Windows in Visual Basic o le applicazioni console in Visual C#, dispongono di un set obbligatorio di parametri di contesto che è necessario passare loro.Per informazioni dettagliate, vedere ContextParams Enum.Nelle procedure guidate create dall'utente è possibile includere un numero variabile di parametri.

Valore restituito

Tipo: EnvDTE.wizardResult
Un oggetto wizardResult.

Note

Il thread principale dell'interfaccia utente dell'IDE e l'esecuzione della procedura guidata sono sincroni. In questo modo gli utenti non possano eseguire alcuna operazione finché la procedura guidata non è stata completata.

Nell'esempio di macro riportato di seguito viene mostrato come utilizzare il metodo LaunchWizard per avviare la procedura guidata Aggiungi elemento di Visual Studio. In questa procedura guidata vengono utilizzati sette parametri personalizzati, quindi i valori vengono impostati per ciascun parametro. Eventuali eccezioni vengono individuate dal blocco Try...Catch.

Esempi

Sub LaunchWizardExample()
   Dim params() As Object = New Object() { _
     "{0F90E1D0-4999-11D1-B6D1-00A0C90F2744}", _  ' Param 0
     "MyConsoleProject", _                        ' Param 1
     "C:\MyProjects", _                           ' Param 2
     "", _                                        ' Param 3
     False, _                                     ' Param 4
     "", _                                        ' Param 5
     False}                                       ' Param 6
   ' The wizardResult constant determines the state of the wizard, such 
   ' as did it complete or was it canceled, etc.
   Dim res As EnvDTE.wizardResult
   ' Set the project type to a Visual Basic project.
   Dim s As String = _
     DTE.Solution.TemplatePath(VSLangProj.PrjKind.prjKindVBProject)

   ' Launch the Visual Basic Console Application wizard using the
   ' supplied parameters. Any exceptions are caught below.
   Try
      res = DTE.LaunchWizard(s & "ConsoleApplication.vsz", params)
   Catch e1 As System.Exception
      MsgBox("Error: " & e1.Message)
   End Try
End Sub

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

_DTE Interfaccia

Spazio dei nomi EnvDTE

Condividi tramite