Agregar referencia (Cuadro de diálogo)

Actualización: noviembre 2007

El cuadro de diálogo Agregar referencia muestra paneles organizados en fichas que muestran los distintos tipos de componentes y proyectos que se pueden explorar. Para ver el cuadro de diálogo Agregar referencia, haga clic en Agregar referencia en el menú Proyecto o haga clic con el botón secundario en el nodo Referencia del Explorador de soluciones y haga clic en Agregar referencia. En el cuadro de diálogo Agregar referencia, seleccione la ficha del tipo de componente que desea examinar.

Nota:

El número de fichas disponibles en la parte superior del cuadro de diálogo Agregar referencia varía en función del tipo de proyecto abierto y de los recursos que éste utiliza. Asimismo, es posible que algunos componentes de la lista estén deshabilitados y se muestren en gris, según la versión .NET Framework del proyecto. Esto se debe a que algunos componentes de una versión de .NET Framework más reciente no son compatibles con los proyectos basados en una versión de .NET Framework anterior.

Al cambiar el cuadro de diálogo Agregar referencia, se edita el archivo de referencias de proyecto del proyecto seleccionado. Un archivo de referencias del proyecto contiene información sobre los requisitos en tiempo de ejecución de una aplicación o componente, como los archivos necesarios, el modo en que se van a registrar y el lugar del equipo del usuario en el que se deben instalar. El cuadro de diálogo Agregar referencia también agrega las jerarquías de objeto correspondientes a los proyectos seleccionados al ámbito de exploración en Vista de clases y el Examinador de objetos.

Nota de seguridad:

Al incorporar componentes que requieren la ejecución de permisos de plena confianza, tenga en cuenta que se pueden producir infracciones de seguridad de acceso a código. Durante el desarrollo, el proyecto se ejecuta en plena confianza, pero el entorno en el que se implementa podría ser de confianza parcial. Si el entorno en el que trabaja en tiempo de ejecución es de confianza parcial, podría obtener infracciones de seguridad de acceso al código. Por lo tanto, es necesario probar las aplicaciones en una amplia gama de escenarios que le ofrezcan confianza.

Están disponibles las fichas y los controles siguientes:

  • Ficha .NET
    Enumera todos los componentes de .NET Framework disponibles para hacer referencias.

    Componente

    Descripción

    Nombre de componente

    Nombre completo o nombre descriptivo del componente.

    Versión

    El número de versión del componente.

    Runtime

    El número de la versión de .NET Framework con que se creó el componente.

    Ruta de acceso

    Ruta de acceso de la carpeta y nombre de archivo del componente.

  • Ficha COM
    Enumera todos los componentes COM disponibles para hacer referencias.

    Nota:

    Esta ficha no aparece durante el desarrollo de proyectos para Smart Device.

  • Ficha Proyectos
    Enumera los proyectos de Visual Studio en la solución actual disponibles para crear referencias. Seleccione en esta ficha los ensamblados para crear las referencias entre proyectos.

    Componente

    Descripción

    Nombre de proyecto

    Muestra los nombres de los proyectos a los que se hace referencia.

    Directorio del proyecto

    Muestra la ruta de acceso de la carpeta para los proyectos a los que se hace referencia.

  • Ficha Examinar
    Permite examinar otros archivos para buscar componentes no mostrados en la ficha actual y agregarlos a la lista.

  • Ficha Reciente
    Muestra las referencias agregadas recientemente.

    Componente

    Descripción

    Nombre de componente

    Nombre completo o nombre descriptivo del componente.

    Tipo

    Tipo de componente que se muestra.

    Versión

    El número de versión del componente.

    Origen

    Nombre de archivo del componente y ruta de acceso a la carpeta donde se encuentra.

Mostrar un ensamblado en el cuadro de diálogo Agregar referencia

El cuadro de diálogo Agregar referencia no muestra automáticamente todos los ensamblados, aunque se haya instalado un ensamblado en la Caché de ensamblados global (GAC). El cuadro de diálogo Agregar referencia se basa en la ruta de acceso y existen varios métodos para mostrar un ensamblado:

  • Copie o mueva el ensamblado al directorio del proyecto actual (puede buscar estos ensamblados con la ficha Examinar), a otros directorios del proyecto dentro de la misma solución (puede buscar estos ensamblados con la ficha Proyectos) o a la carpeta de ensamblados públicos en Archivos de programa\Microsoft Visual Studio .NET\Common7\IDE\Public Assemblies (puede buscar estos ensamblados en la ficha .NET).

  • Establezca una ruta de acceso de referencia al directorio que contiene el ensamblado mediante Rutas de acceso de referencia (Cuadro de diálogo) (Visual Basic) o Rutas de acceso de referencia (Página, Diseñador de proyectos) (C#).

  • Establezca una clave del Registro que especifique la ubicación de los ensamblados que se van a mostrar.

Para obtener información detallada sobre cómo mostrar un ensamblado en el cuadro de diálogo Agregar referencia, vea Cómo: Agregar o quitar referencias en Visual Studio (Visual Basic).

La lista de referencias depende de la versión de .NET Framework de destino

Los componentes de referencia que se muestran en el cuadro de diálogo Agregar referencia se vinculan a la versión de .NET Framework que se utiliza en el proyecto. Los componentes que no son de aplicación en .NET Framework del proyecto aparecerán en gris en la lista y no se pueden agregar como una referencia al proyecto.

Vea también

Tareas

Cómo: Agregar o quitar referencias en Visual Studio (Visual Basic)

Cómo: Agregar y quitar referencias en Visual Studio (C#)

Cómo: Ver y modificar el ámbito de exploración

Cómo: Explorar en el Examinador de objetos

Cómo: Buscar objetos, definiciones y referencias (símbolos)

Conceptos

Configuraciones de compilación

Proyectos como contenedores

Administración de elementos en proyectos

Referencia

Elegir elementos del cuadro de herramientas (Cuadro de diálogo): Visual Studio

Examinar código y componentes