Metoda _DTE.LaunchWizard —
Uruchamia kreatora 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: System.String
Wymagane..Plik Vsz (Kreator), zawierający informacje wymagane do uruchomienia kreatora.
- ContextParams
Typ: array<System.Object[]%
Wymagane.Parametry dla kreatora.Pierwszy parametr jest identyfikator GUID, który unikatowo identyfikuje kontekst uruchomienia 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 Visual C# aplikacji konsoli — zestaw wymaganych parametrów kontekstu, które trzeba przekazać im.Szczegółowe informacje na temat tych Zobacz wyliczenie ContextParams.Kreatory, które tworzysz może mieć więcej lub mniej parametrów.
Wartość zwracana
Typ: EnvDTE.wizardResult
A wizardResult object.
Uwagi
Główny wątek Interfejsu IDE jest synchroniczne z wykonania kreatora, więc użytkownicy nie mogą nic zrobić dopiero po zakończeniu kreatora.
W poniższym przykładzie makro demonstruje, jak używać LaunchWizard metoda, aby uruchomić Visual Studio kreatora Dodaj element.Ten kreator używa siedmiu niestandardowe parametry, więc wartości 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 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 Przy użyciu bibliotek z częściowo zaufanego kodu..