Compartir a través de

Cómo: Agregar referencias a los espacios de nombres de automatización

  • Artículo

Cuando se agrega una referencia a EnvDTE, EnvDTE80, EnvDTE90 o EnvDTE100, existe la opción de utilizar un ensamblado .NET o una versión de la biblioteca COM. La elección se debe realizar en función del proyecto.

Para efectuar el mantenimiento de una aplicación de automatización o un complemento antiguos, es posible que deba utilizar la versión COM de EnvDTE, EnvDTE80, EnvDTE90 o EnvDTE100. Sin embargo, para la creación de una aplicación administrada o un complemento nuevos, lo más probable es que se deba utilizar la versión del ensamblado .NET.

Cuando se utiliza el Asistente para complementos para crear un complemento en cualquier lenguaje de programación o al crear una macro, el proceso agrega las referencias a los ensamblados EnvDTE, EnvDTE90, Env90 y Env100. Además, en el archivo que contiene la clase Connect, agrega las directivas using (en Visual Basic, imports) a los espacios de nombres EnvDTE80 y EnvDTE.

Sin embargo, a fin de tener acceso a los objetos de automatización fuera de las macros o los complementos creados con el Asistente para complementos, se deben agregar manualmente las referencias de ensamblado y las directivas using (en Visual Basic, imports). Al agregar manualmente una referencia de ensamblado, también se debe establecer la propiedad Incrustar tipos de interoperabilidad del ensamblado en false. Para ello, siga estos pasos:

  1. Agregue la referencia de ensamblado. En el Explorador de soluciones, haga clic con el botón secundario del mouse en el proyecto y seleccione Agregar referencia. En la pestaña .NET, seleccione el ensamblado y haga clic en Aceptar. En un proyecto de C#, verá el nombre del ensamblado bajo el nodo Referencias en el Explorador de soluciones. Si el proyecto es de Visual Basic, verá el nombre del ensamblado en las propiedades del proyecto. En el Explorador de soluciones, haga clic con el botón secundario del mouse en el proyecto y seleccione Propiedades. Aparecerán las páginas de propiedades. Seleccione la página Referencias en el recuadro izquierdo.

  2. Seleccione la referencia de ensamblado; en la ventana Propiedades, establezca la propiedad Incrustar tipos de interoperabilidad del ensamblado en false.

Después de tener referencias a los espacios de nombres, probablemente deseará programar en los objetos DTE y DTE2. Para obtener más información, vea Cómo: Obtener referencias para los objetos DTE y DTE2.

Nota

Los cuadros de diálogo y comandos de menú que se ven pueden diferir de los descritos en la Ayuda, en función de los valores de configuración o de edición activos. Estos procedimientos se han desarrollado con la Configuración de desarrollo general activa. Para cambiar la configuración, elija la opción Importar y exportar configuraciones del menú Herramientas. Para obtener más información, vea Trabajar con valores de configuración.

Para agregar manualmente referencias a los espacios de nombres EnvDTE en Visual Basic o Visual C#

  1. En el Explorador de soluciones, haga clic con el botón secundario del mouse en el nodo del proyecto o de las referencias y haga clic en Agregar referencia, o bien haga clic en el comando Agregar referencia del menú Proyecto.

  2. En el cuadro de diálogo Agregar referencia, seleccione la ficha que indique el tipo de componente al que desea hacer referencia; por ejemplo, .NET o COM.

  3. Desplácese hacia abajo por la lista, seleccione EnvDTE, EnvDTE80, EnvDTE90 y EnvDTE100.

  4. Haga clic en Aceptar para agregar las dos nuevas referencias al proyecto.

  5. Con el fin de habilitar Intellisense para los nuevos ensamblados en el editor de código, en la parte superior del módulo o clase del proyecto, agregue una de las siguientes opciones:

    Imports EnvDTE
Imports EnvDTE80
Imports EnvDTE90
Imports EnvDTE100

    using EnvDTE;
using EnvDTE80;
using EnvDTE90;
using EnvDTE100;

Para agregar manualmente referencias a los espacios de nombres EnvDTE en Visual C++ administrado

  1. En el Explorador de soluciones, haga clic con el botón secundario del mouse en el nodo del proyecto y haga clic en Agregar referencias, o bien haga clic en el comando Agregar referencias del menú Proyecto.

  2. Haga clic en Agregar nueva referencia y, a continuación, en la ficha .NET.

  3. Desplácese hacia abajo por la lista, seleccione EnvDTE, EnvDTE80 y EnvDTE90 y, a continuación, haga clic en Agregar.

  4. Haga clic en Aceptar para agregar las referencias nuevas al proyecto.

  5. Con el fin de habilitar Intellisense para los nuevos ensamblados en el editor de código, en la parte superior del archivo del proyecto principal, agregue lo siguiente:

    // Visual C++
#using <envdte.dll>
#using <envdte80.dll>
#using <envdte90.dll>
#using <envdte100.dll>

Para agregar referencias a los espacios de nombres EnvDTE y EnvDTE80 en Visual C++ no administrado (ATL)

  • En el archivo de encabezado o de código fuente que convenga, agregue lo siguiente:

    #pragma warning( disable : 4278 )
#pragma warning( disable : 4146 )
//The following #import imports EnvDTE based on its LIBID.
#import "libid:80cc9f66-e7d8-4ddd-85b6-d9e6cd0e93e2" version("8.0") 
lcid("0") raw_interfaces_only named_guids
//The following #import imports EnvDTE80 based on its LIBID.
#import "libid:1A31287A-4D7D-413e-8E32-3B374931BD89" version("8.0") 
lcid("0") raw_interfaces_only named_guids
//The following #import imports EnvDTE90 based on its LIBID.
#import "libid: 2ce2370e-d744-4936-a090-3fffe667b0e1" version("9.0") 
lcid("0") raw_interfaces_only named_guids
//The following #import imports EnvDTE100 based on its LIBID.
#import "libid: 26ad1324-4b7c-44bc-84f8-b86aed45729f" version("10.0") 
lcid("0") raw_interfaces_only named_guids
#pragma warning( default : 4146 )
#pragma warning( default : 4278 )

Vea también

Tareas

Cómo: Controlar complementos con el Administrador de complementos

Tutorial: Crear un asistente

Conceptos

Registro de complementos

Gráfico del modelo de objetos de automatización

Otros recursos

Crear complementos y asistentes