_DTE.LaunchWizard (Método)
Ejecuta un asistente con los parámetros proporcionados.
Espacio de nombres: EnvDTE
Ensamblado: EnvDTE (en EnvDTE.dll)
Sintaxis
'Declaración
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
Requerido.Archivo .Vsz (asistente) que contiene la información necesaria para iniciar el asistente.
- ContextParams
Tipo: array<System.Object[]%
Requerido.Parámetros correspondientes al asistente.El primer parámetro es un GUID que únicamente identifica el contexto del inicio, a diferencia de Add Item, Add Project o un GUID personalizado.Los argumentos restantes están definidos por el usuario, y su número y valores dependen del asistente.
Los asistentes (o plantillas) que vienen con Visual Studio, como Aplicación para Windows de Visual Basic o Aplicación de consola de Visual C#, tienen un conjunto necesario de parámetros de contexto que se les debe pasar.Para obtener detalles al respecto, vea ContextParams (Enumeración).Los asistentes que se creen podrán tener más o menos parámetros.
Valor devuelto
Tipo: EnvDTE.wizardResult
Un objeto wizardResult.
Comentarios
El subproceso de la IU principal es sincrónico con la ejecución del asistente, por lo que los usuarios no pueden hacer nada mientras no finalice el asistente.
En el siguiente ejemplo de macro se muestra cómo se utiliza el método LaunchWizard para iniciar el Asistente para agregar elementos de Visual Studio.Este asistente utiliza siete parámetros personalizados, por lo que se establecerán valores para cada uno de ellos.El bloque Try...Catch detectará cualquier excepción.
Ejemplos
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
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.