Metoda _DTE.LaunchWizard —

Kreator jest uruchamiany z podanych parametrów.

Przestrzeń nazw:  EnvDTE
Zestaw:  EnvDTE (w EnvDTE.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

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

• ContextParams
  Typ: array<Object[]%

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

  Kreatorzy (lub szablonów), które pochodzą z Visual Studio — takie jak Visual Basic aplikacji systemu Windows lub Visual C# Console Application — mają zestaw wymaganych parametrów kontekstu, które trzeba przekazać im.Aby uzyskać szczegóły na temat tych Zobacz wyliczenie ContextParams.Kreatory, które tworzysz może mieć bardziej lub mniej parametrów.

Wartość zwracana

Typ: EnvDTE.wizardResult
Obiekt wizardResult.

Uwagi

Główny wątek Interfejsu IDE jest synchroniczne wykonywanie kreatora, więc użytkownicy nie można nic zrobić dopiero po zakończeniu kreatora.

W poniższym przykładzie makro pokazuje sposób użycia LaunchWizard sposobem uruchamiania Visual Studio kreatora Dodaj element.Ten kreator używa siedmiu parametry niestandardowe, więc wartości są ustawione dla każdego z nich.Wszelkie wyjątki są objęte 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 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

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

_DTE Interfejs

Przestrzeń nazw EnvDTE