Cómo: Compilar y ejecutar los ejemplos de código del modelo de objetos de automatización

Actualización: noviembre 2007

Los ejemplos de código que se encuentran en los temas de referencia del modelo de objetos de automatización están diseñados para ejecutarse en un complemento creado por el Asistente para complementos. Además, los ejemplos de código de Visual Basic se pueden ejecutar como una macro. Las secciones siguientes explican cómo compilar y ejecutar los ejemplos de código del modelo de objetos de automatización.

Para ejecutar un ejemplo de código en un complemento

1. Cree un complemento mediante el Asistente para complementos.

   Para obtener más información, vea Cómo: Crear un complemento.

2. Agregue el ejemplo de código a la clase Connect del complemento.

3. Llame al procedimiento del ejemplo de código desde el método OnConnection del complemento. Si el ejemplo de código requiere el objeto DTE2 como argumento, pase la variable miembro _applicationObject, que se declara en el código del complemento. El código siguiente muestra las partes importantes de la clase Connect de un complemento de Visual Basic y de Visual C#:

   Public Sub OnConnection(ByVal application As Object, ... ) _
     Implements IDTExtensibility2.OnConnection
   
       _applicationObject = CType(application, EnvDTE80.DTE2)
           .
           .
           .
       ' Pass the _applicationObject member variable to the code 
       ' example.
       MyCodeExample(_applicationObject)
   End Sub
   ' Other methods in the Connect class.
       .
       .
       .
   
   ' This is the code example that was added to the Connect class.
   Sub MyCodeExample(ByVal dte As DTE2)
       .
       .
       .
   End Sub
   

   public void OnConnection(object application, ... , ref Array custom)
   {
       _applicationObject = (_DTE2)application;
           .
           .
           .
       // Pass the _applicationObject member variable to the code 
       // example.
       MyCodeExample(_applicationObject);
   }
   
   
   // Other methods in the Connect class.
       .
       .
       .
   
   // This is the code example that was added to the Connect class.
   void MyCodeExample(DTE2 dte)
   {
       .
       .
       .
   }
   

4. En los complementos de Visual C#, haga clic en el nombre del proyecto de complemento en el Explorador de soluciones, seleccione la opción Agregar referencia del menú Proyecto, y elija System.Windows.Forms.dll en el cuadro de diálogo Agregar referencia para agregar una referencia al ensamblado System.Windows.Forms.

   1. En los complementos de Visual C#, inserte el código siguiente en la parte superior del archivo Connect.cs:

      using System.Windows.Forms;
      

5. Seleccione la opción Generar solución del menú Generar para compilar el complemento.

6. Seleccione la opción Administrador de complementos del menú Herramientas.

   Aparece el cuadro de diálogo Administrador de complementos.

7. Active la casilla de verificación situada junto al nombre del complemento en el cuadro de diálogo Administrador de complementos y haga clic en Aceptar para cargar el complemento.

Para ejecutar un ejemplo de código de Visual Basic como macro

1. En el menú Herramientas, elija Macros y después haga clic en IDE de macros.

   Aparece el IDE de macros.

2. En el menú Ver del IDE de macros, haga clic en el Explorador de proyectos.

3. Expanda el nodo MyMacros en el Explorador de proyectos.

4. Haga doble clic en Module1.

5. Agregue el ejemplo de código al archivo del módulo.

6. Si el ejemplo de código requiere el objeto DTE como argumento, cree una macro sin parámetros que pase la variable DTE global al ejemplo de código. El código siguiente muestra cómo hacerlo:

   ' Visual Basic
   ' Macro without parameters that calls the code example.
   Sub CodeExample()
       CodeExample(DTE2)
   End Sub
   
   ' Original code example.
   Sub CodeExample(ByVal dte As DTE2)
       .
       .
       .
   End Sub
   

7. Cierre el IDE de macros.

8. En el menú Herramientas del IDE de Visual Studio, elija Macros y haga clic en el Explorador de macros.

   Aparece la ventana Explorador de macros.

9. En el Explorador de macros, expanda el nodo MyMacros y, a continuación, expanda el nodo Module1.

10. En el Explorador de macros, haga clic con el botón secundario del mouse (ratón) en el nombre de la macro de ejemplo de código y seleccione Ejecutar en el menú contextual.

Vea también

Tareas

Cómo: Crear un complemento

Cómo: Controlar complementos con el Administrador de complementos

Cómo: Editar y crear macros mediante programación

Conceptos

Registro de complementos