DTE2.LaunchWizard (Método)
Ejecuta un asistente con los parámetros proporcionados.
Espacio de nombres: EnvDTE80
Ensamblado: EnvDTE80 (en EnvDTE80.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: StringObligatorio. Archivo .Vsz (asistente) que contiene la información necesaria para iniciar el asistente.
ContextParams
Tipo: array<Object[]%Obligatorio. 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 incluye Visual Studio (como Aplicación para Windows de Visual Basic o Aplicación de consola de Visual C#) necesitan para funcionar que el usuario les pase determinados parámetros de contexto. 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: wizardResult
Un objeto wizardResult.
Comentarios
El subproceso de la interfaz de usuario principal del IDE 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 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
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.