Método DTE2.LaunchWizard (String, array<Object %)
Executa um assistente com os parâmetros fornecidos.
Namespace: EnvDTE80
Assembly: EnvDTE80 (em EnvDTE80.dll)
Sintaxe
'Declaração
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
Parâmetros
- VSZFile
Tipo: System.String
Obrigatório.A.Arquivo vsz (Assistente) que contém as informações necessárias para iniciar o assistente.
- ContextParams
Tipo: array<System.Object[]%
Obrigatório.Os parâmetros para o assistente.O primeiro parâmetro é um GUID que identifica com exclusividade o contexto de lançamento diferentes de Add Item ou Add Project ou um GUID personalizado.Os argumentos restantes são definidos pelo usuário e seus valores e o número dependem do assistente.
Assistentes (ou modelos) que vêm com o Visual Studio — como Visual Basic aplicativo do Windows ou do aplicativo de Console do Visual C# — um conjunto necessário de parâmetros de contexto que você deve passar a eles.Para obter detalhes sobre elas, consulte a enumeração de ContextParams.Assistentes que você criar podem ter parâmetros mais ou menos.
Valor de retorno
Tipo: EnvDTE.wizardResult
A wizardResult object.
Comentários
O segmento de interface (UI) do usuário principal do IDE é síncrono com execução do assistente, para que os usuários não podem fazer nada até a conclusão do assistente.
O exemplo de macro a seguir demonstra como usar o LaunchWizard método para iniciar o Visual Studio assistente Add Item.Este assistente usa sete parâmetros personalizados, para que os valores são definidos para cada um deles.Todas as exceções são detectadas pela Try...Catch bloco.
Exemplos
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 whether it completed, was canceled, and so on.
Dim res As EnvDTE.wizardResult
' Set the project type to a Visual Basic project.
Dim str As String = _
DTE.Solution.TemplatePath(VSLangProj.PrjKind.prjKindVBProject)
' Start the Visual Basic Console Application wizard by using the
' supplied parameters. Exceptions are caught below.
Try
res = DTE2.LaunchWizard(str & "ConsoleApplication.vsz", params)
Catch e1 As System.Exception
MsgBox("Error: " & e1.Message)
End Try
End Sub
Segurança do .NET Framework
- Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.