_DTE.LaunchWizard 메서드
제공된 매개 변수를 사용하여 마법사를 실행합니다.
네임스페이스: EnvDTE
어셈블리: EnvDTE(EnvDTE.dll)
구문
‘선언
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
매개 변수
- VSZFile
형식: System.String
필수적 요소로서,마법사를 시작하는 데 필요한 정보가 들어 있는 .Vsz 마법사 파일입니다.
- ContextParams
형식: array<System.Object[]%
필수적 요소로서,마법사에 대한 매개 변수입니다.첫째 매개 변수는 시작 컨텍스트를 Add Item 또는 Add Project와 다른 것으로 고유하게 식별하는 GUID 또는 사용자 지정 GUID입니다.나머지는 사용자 정의 인수이며 그 수와 값은 마법사에 따라 다릅니다.
Visual Basic Windows 응용 프로그램 또는 Visual C# 콘솔 응용 프로그램과 같이 Visual Studio와 함께 제공되는 마법사나 템플릿에는 사용자가 몇 가지 컨텍스트 매개 변수를 전달해야 합니다.자세한 내용은 ContextParams Enum을 참조하십시오.사용자가 만드는 마법사에는 매개 변수를 더 많이 또는 적게 사용할 수 있습니다.
반환 값
형식: EnvDTE.wizardResult
wizardResult 개체입니다.
설명
IDE의 주 UI 스레드와 마법사의 실행은 동기화되어 있으므로, 사용자는 마법사가 종료될 때까지 어떤 동작도 수행할 수 없습니다.
다음 매크로 예제에서는 LaunchWizard 메서드를 사용하여 Visual Studio 항목 추가 마법사를 시작하는 방법을 보여 줍니다. 이 마법사에는 사용자 지정 매개 변수 7개가 사용되며, 각각에 대해 값이 설정됩니다. 모든 예외는 Try...Catch 블록으로 catch됩니다.
예제
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
.NET Framework 보안
- 직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.