_DTE.LaunchWizard - метод

Статья
05/17/2015

Запускает мастер с предоставленными параметрами.

Пространство имен: 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
Тип: String

Обязательное. VSZ-файл (файл мастера) содержащий сведения, необходимые для запуска мастера.

ContextParams
Тип: array<Object[]%

Обязательное. Параметры мастера. Первый параметр — это идентификатор GUID, который уникально идентифицирует контекст запуска, отличный от Add Item или Add Project, либо пользовательский GUID. Остальные элементы определяются пользователем, и их количество и значения зависят от мастера.

Мастера (или шаблоны), которые поставляются вместе с Visual Studio, например приложение Windows Visual Basic или консольное приложение Visual C#, имеют необходимый набор параметров контекста, которые должны быть указаны при их запуске. Сведения об этих параметрах см. в описании перечисления ContextParams. В мастерах, создаваемых пользователем, может использоваться различное число параметров.

Возвращаемое значение

Тип: EnvDTE.wizardResult
Объект wizardResult.

Заметки

Главный поток пользовательского интерфейса интегрированной среды разработки является синхронным по отношению к выполнению мастера, поэтому пользователи не могут ничего сделать до завершения работы мастера.

Следующий макрос показывает использование метода LaunchWizard для запуска мастера "Добавить элемент" Visual Studio. В этом мастере используется семь пользовательских параметров, для каждого из которых задается значение. Все исключения перехватываются блоком Try...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 - пространство имен

Поделиться через