_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 보안

  • 직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.

참고 항목

참조

_DTE 인터페이스

EnvDTE 네임스페이스