Metodo DTE2.LaunchWizard (String, array<Object %)

Articolo
08/11/2011

Esegue una procedura guidata con i parametri specificati.

Spazio dei nomi: EnvDTE80
Assembly: EnvDTE80 (in EnvDTE80.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, 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.

Implementa

_DTE.LaunchWizard(String, array<Object[]%)

Note

Il thread principale dell'interfaccia utente dell'IDE e l'esecuzione della procedura guidata sono sincroni. Pertanto, gli utenti non possono eseguire alcuna operazione finché la procedura guidata non viene 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 whether it completed, was canceled, and so on.
   Dim res As EnvDTE.wizardResult
   ' Set the project type to a Visual Basic project.
   Dim str As String = _
     DTE.Solution.TemplatePath(VSLangProj.PrjKind.prjKindVBProject)

   ' Start the Visual Basic Console Application wizard by using the
   ' supplied parameters. Exceptions are caught below.
   Try
      res = DTE2.LaunchWizard(str & "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.