Metoda DTE2.LaunchWizard —

Uruchamia kreatora z podanych parametrów.

Przestrzeń nazw:  EnvDTE80
Zestaw:  EnvDTE80 (w EnvDTE80.dll)

Składnia

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

  Wymagane..Plik Vsz (Kreator), zawierający informacje wymagane do uruchomienia kreatora.

• ContextParams
  Typ: array<Object[]%

  Wymagane.Parametry dla kreatora.Pierwszy parametr jest identyfikator GUID, który unikatowo identyfikuje kontekście uruchamiania, w odróżnieniu od Add Item lub Add Project lub niestandardowego identyfikatora GUID.Pozostałe argumenty są zdefiniowane przez użytkownika i ich liczby i wartości zależą od kreatora.

  Kreatorzy (lub szablonów), pochodzących z Visual Studio — takie jak Visual Basic aplikacji systemu Windows lub aplikacji Visual C# konsoli — mają wymagany zestaw parametrów kontekstu, które trzeba przekazać im.Szczegółowe informacje na temat tych Zobacz wyliczenia ContextParams.Kreatory, które można utworzyć może mieć mniej lub więcej parametrów.

Wartość zwracana

Typ: wizardResult
A wizardResult object.

Uwagi

Wątek interfejsu użytkownika główny IDE jest synchroniczne wykonywanie kreatora, więc użytkownicy nie można nic zrobić, aż Kreator ukończy.

Poniższy przykład makro przedstawiono sposób użycia LaunchWizard metodę, aby uruchomić Visual Studio kreatora Dodaj element.Ten kreator używa siedmiu parametry niestandardowe, więc wartości są ustawione dla każdego z nich.Wszystkie wyjątki zostały złowione przez Try...Catch bloku.

Przykłady

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

Zabezpieczenia programu .NET Framework

• Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Używanie bibliotek pochodzących z częściowo zaufanego kodu.

Zobacz też

Informacje

DTE2 Interfejs

Przestrzeń nazw EnvDTE80