_DTE.LaunchWizard – metoda

Článek
05/16/2015

Spustí Průvodce pomocí zadaných parametrů.

Obor názvů: EnvDTE
Sestavení: EnvDTE (v EnvDTE.dll)

Syntaxe

'Deklarace
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

Parametry

VSZFile
Typ: String

Požadováno.Na.Soubor vsz (Průvodce), obsahující informace potřebné ke spuštění průvodce.

ContextParams
Typ: array<Object[]%

Požadováno.Parametry pro průvodce.První parametr je identifikátor GUID, který jednoznačně určuje kontext spuštění formou Add Item nebo Add Project nebo vlastní identifikátor GUID.Zbývající argumenty jsou definovány uživatelem a jejich počet a hodnoty závisí na průvodce.

Průvodci (nebo šablony), které jsou součástí Visual Studio -jako Visual Basic aplikace pro systém Windows nebo Visual C# aplikaci konzoly systému Windows – požadovaná sada kontextu parametry, které je třeba předat.Podrobnosti o nich naleznete v tématu Výčet ContextParams.Průvodců, které vytvoříte mohou mít více nebo méně parametrů.

Vrácená hodnota

Typ: EnvDTE.wizardResult
Objekt wizardResult.

Poznámky

Hlavní podproces uživatelského rozhraní, rozhraní IDE je synchronní s spuštění průvodce, takže uživatelé nemohou provádět akce, dokud průvodce nedokončí.

Následující příklad makro demonstruje použití LaunchWizard metoda spustit Visual Studio průvodce přidat položku.Tento průvodce používá sedm vlastní parametry, takže hodnoty jsou nastaveny pro každou z nich.Jakékoli výjimky jsou zachycena Try...Catch blok.

Příklady

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

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Referenční dokumentace

_DTE Rozhraní

EnvDTE – obor názvů

Sdílet prostřednictvím