DTE2.LaunchWizard – metoda (String, array<Object %)

Článek
08/11/2011

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

Obor názvů: EnvDTE80
Sestavení: EnvDTE80 (v EnvDTE80.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: System.String
Povinné.Na.Vsz (Průvodce) soubor obsahující informace požadované pro spuštění průvodce.

ContextParams
Typ: array<System.Object[]%
Povinné.Parametry pro průvodce.První parametr je identifikátor GUID, který jedinečně identifikuje spuštění kontextu, Add Item nebo Add Project nebo vlastní identifikátor GUID.Zbývající argumenty jsou definovány uživatelem a jejich čísla a hodnoty závisí na průvodce.
Průvodci (nebo šablony) které jsou součástí Visual Studio – například Visual Basic Visual C# konzolové aplikace nebo aplikace systému Windows – požadovaná sada kontextu parametry, které je třeba předat.Podrobnosti o nich naleznete výčet ContextParams.Průvodců, které vytvoříte, můžete mít více nebo méně parametrů.

Vrácená hodnota

Typ: EnvDTE.wizardResult
A wizardResult objektu.

Implementuje

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

Poznámky

Podproces hlavního uživatelského rozhraní IDE je synchronní s spuštění průvodce, takže uživatelé nemohou provádět až do dokončení průvodce.

Následující makro příklad demonstruje použití LaunchWizard Metoda spuštění 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. Jsou výjimky zachycené Try...Catch bloku.

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

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.