Cómo: Agregar o quitar referencias utilizando el cuadro de diálogo Agregar referencia

  • Artículo

Para usar un componente en su aplicación, debe agregar primero una referencia al mismo.Visual Studio proporciona cinco opciones en el cuadro de diálogo Agregar referencia:

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

  • COM enumera todos los componentes de COM disponibles para hacer referencias.

  • Proyectos enumera todos los componentes reutilizables creados en proyectos locales.

  • Examinar permite buscar un componente en el sistema de archivos.

  • Reciente contiene una lista de componentes agregados recientemente a proyectos de su equipo.

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.Los proyectos nativos de C++ solo contienen la pestaña Proyectos.

Dependiendo de la versión de .NET Framework del proyecto, es posible que algunos componentes de la lista no aparezcan.Esta desincronización puede aparecer bajo las condiciones siguientes:

  • Un componente que utiliza una versión reciente de .NET Framework es incompatible con un proyecto que tiene como destino una versión anterior de .NET Framework.

    Para obtener más información sobre cómo cambiar la versión de .NET Framework de destino de un proyecto, vea Cómo: Usar como destino una versión de .NET Framework.

  • Un componente que utiliza .NET Framework 4 es incompatible con un proyecto que tiene como destino .NET Framework 4 Client Profile.

    Al crear una nueva aplicación, algunos proyectos tienen como destino .NET Framework 4 Client Profile de forma predeterminada.Para obtener más información, vea .NET Framework Client Profile.

No puede agregar referencias de la memoria caché global de ensamblados (GAC), ya que forma parte estrictamente del entorno en tiempo de ejecución.

Si se implementa o copia una aplicación que contiene una referencia a un componente personalizado registrado en la memoria caché global de ensamblados, el componente no se implementará o copiará con la aplicación, independientemente de la configuración de Copy Local.Para obtener más información, vea Administrar referencias de proyecto..

Puede crear aplicaciones que hagan referencia a proyectos o ensamblados destinados a otra versión de .NET Framework.Por ejemplo, podría crear una aplicación destinada a .NET Framework 4 Client Profile que haga referencia a un ensamblado destinado a .NET Framework 2,0.Si crea un proyecto destinado a una versión anterior de .NET Framework, no puede establecer una referencia en ese proyecto a un proyecto o ensamblado destinado a .NET Framework 4 Client Profile o .NET Framework 4.Para obtener más información, vea Elegir versión de destino o perfil de .NET Framework específico.

No se deben agregar referencias de archivos a resultados de otro proyecto de la misma solución, ya que puede provocar errores de compilación.En lugar de hacerlo, use la ficha Proyectos del cuadro de diálogo Agregar referencias para crear referencias entre proyectos.Esto facilita el trabajo en equipo, permitiendo una mejor administración de las bibliotecas de clases creadas en los proyectos.Para obtener más información, vea Solucionar problemas de referencias rotas.

[!NOTA]

En Visual Studio 2010, se crea una referencia de archivo en lugar de una referencia de proyecto si la versión de destino de .NET Framework de un proyecto es la 4 y la versión de .NET Framework de destino del otro proyecto es 2, 3 ó 3.5.

Si desea agregar una referencia a una DLL COM registrada que contiene un manifiesto interno, asegúrese de eliminar previamente la DLL del Registro.Si no lo hace, Visual Studio agregará la referencia del ensamblado como un componente de ActiveX, en lugar de como una DLL nativa.

También puede agregar referencias web en el cuadro de diálogo Agregar referencia Web.Para obtener más información, vea How to: Add and Remove Web References.

Al agregar manualmente una referencia a cualquiera de los espacios de nombres EnvDTE (EnvDTE, EnvDTE80, EnvDTE90, EnvDTE90a o EnvDTE100), establezca la propiedad Incrustar tipos de interoperabilidad de la referencia en False en la ventana Propiedades.Establecer esta propiedad en True puede producir problemas de compilación debido a ciertas propiedades EnvDTE que no se pueden insertar.

[!NOTA]

Todos los proyectos contienen una referencia implícita a mscorlib.Los proyectos de Visual Basic contienen una referencia implícita a Microsoft.VisualBasic.

En Visual Studio 2010, todos los proyectos contienen una referencia implícita a System.Core, aun cuando System.Core se quite de la lista de referencias.

Para mostrar un ensamblado en el cuadro de diálogo Agregar referencia

  • Desplace o copie el ensamblado en una de las ubicaciones siguientes:

    • Directorio del proyecto actual. (Puede buscar estos ensamblados utilizando la ficha Examinar.)

    • Otros directorios del proyecto de la misma solución. (Puede buscar estos ensamblados utilizando la ficha Proyectos.)

    O bien

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

    Para un sistema operativo de 32 bits, agregue una de las siguientes claves del Registro.

    • [HKEY_CURRENT_USER\SOFTWARE\Microsoft\.NETFramework\VersionMinimum\AssemblyFoldersEx\MyAssemblies]@="AssemblyLocation"

    • [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\VersionMinimum\AssemblyFoldersEx\MyAssemblies]@="AssemblyLocation"

    Para un sistema operativo de 64 bits, agregue una de las siguientes claves del Registro en un subárbol del Registro de 32 bits.

    • [HKEY_CURRENT_USER\SOFTWARE\Wow6432Node\Microsoft\.NETFramework\VersionMinimum\AssemblyFoldersEx\MyAssemblies]@="AssemblyLocation"

    • [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\.NETFramework\VersionMinimum\AssemblyFoldersEx\MyAssemblies]@="AssemblyLocation"

    VersionMinimum es la versión de .NET Framework más antigua que se aplica.Si VersionMinimum es v3.0, las carpetas especificadas en AssemblyFoldersEx se aplican a proyectos cuyo destino es .NET Framework 3.0 y versiones posteriores.

    AssemblyLocation es el directorio de los ensamblados que desea que aparezcan en el cuadro de diálogo Agregar referencia, por ejemplo, C:\MisEnsamblados\.

    Crear la clave del Registro en el nodo HKEY_LOCAL_MACHINE permite que todos los usuarios vean los ensamblados de la ubicación especificada en el cuadro de diálogo Agregar referencia.Crear la clave del Registro en el nodo HKEY_CURRENT_USER únicamente afecta a la configuración del usuario actual.

    Abra el cuadro de diálogo Agregar referencia de nuevo.Los ensamblados deben aparecer en la pestaña .NET.En caso contrario, asegúrese de que los ensamblados se encuentren en el directorio AssemblyLocation especificado, reinicie Visual Studio e inténtelo de nuevo.

Para agregar una referencia en Visual Basic

  1. En el Explorador de soluciones, haga doble clic en el nodo Mi proyecto del proyecto.

  2. En el Diseñador de proyectos, haga clic en la ficha Referencias.

  3. Haga clic en el botón Agregar para abrir el cuadro de diálogo Agregar referencia.

  4. En el cuadro de diálogo Agregar referencia, seleccione la ficha que indique el tipo de componente al que desea hacer referencia.

  5. Seleccione los componentes a los que desee hacer referencia y haga clic en Aceptar.

    SugerenciaSugerencia

    Puede seleccionar varios componentes si mantiene presionada la tecla CTRL, siempre y cuando todos los componentes estén en la misma ficha.

Para agregar una referencia en Visual C#

  1. En el Explorador de soluciones, haga clic con el botón secundario del mouse en el nodo del proyecto y seleccione Agregar referencia.

  2. En el cuadro de diálogo Agregar referencia, seleccione la ficha que indique el tipo de componente al que desea hacer referencia.

  3. Seleccione los componentes a los que desee hacer referencia y haga clic en Aceptar.

    SugerenciaSugerencia

    Puede seleccionar varios componentes si mantiene presionada la tecla CTRL, siempre y cuando todos los componentes estén en la misma ficha.

Para quitar una referencia en Visual Basic

  1. En el Explorador de soluciones, haga doble clic en el nodo Mi proyecto del proyecto.

  2. En el Diseñador de proyectos, haga clic en la ficha Referencias.

  3. En la lista Referencias, seleccione la referencia que desee quitar.

  4. Haga clic en el botón Quitar.

    SugerenciaSugerencia

    También puede comprobar si en su proyecto hay referencias que no se utilicen y quitarlas todas de una vez.Para obtener más información, vea How to: Remove Unused References (Visual Basic).

Para quitar una referencia en Visual C#

  1. En el Explorador de soluciones, abra el nodo Referencias bajo el nodo de proyecto.

  2. Haga clic con el botón secundario del mouse en una referencia y seleccione Quitar.

Vea también

Tareas

Solucionar problemas de referencias rotas

Cómo: Agregar o quitar espacios de nombres importados (Visual Basic)

Referencia

Página de aplicación, Diseñador de proyectos (C#)

Configuración de compilador avanzada (Cuadro de diálogo, Visual Basic)

Conceptos

Administrar referencias de proyecto.

Cómo: Agregar o quitar referencias usando el Administrador de referencias

Administrar referencias de proyecto.

Información general sobre la compatibilidad con múltiples versiones (multi-targeting) en Visual Studio

Solucionar problemas de versión de .NET Framework de destino

Otros recursos

Elegir versión de destino o perfil de .NET Framework específico