Administrar referencias en un proyecto

2025-06-12

Antes de escribir código en un componente externo o en un servicio conectado, el proyecto debe contener primero una referencia a él. Una referencia es básicamente una entrada de un archivo de proyecto que contiene la información que Visual Studio necesita para localizar el componente o el servicio.

La forma de agregar una referencia depende del tipo de proyecto para el código en el que esté trabajando:

Si ve un nodo Dependencias en el Explorador de soluciones, puede usar el menú contextual del botón derecho para seleccionar Agregar referencia de proyecto.

También puede hacer clic con el botón derecho en el nodo del proyecto y seleccionar Agregar>referencia de proyecto.
Si ve un nodo Referencias en el Explorador de soluciones, puede usar el menú contextual del botón derecho para seleccionar Agregar referencia.

O bien, haga clic con el botón derecho en el nodo del proyecto y seleccione Agregar>referencia.

Para obtener más información, vea Cómo: Agregar o quitar referencias.

Puede agregar una referencia a los siguientes tipos de componentes y servicios:

Bibliotecas de clases o ensamblados de .NET
Aplicaciones para UWP
Componentes COM
Otros ensamblados o bibliotecas de proyectos en la misma solución
Proyectos compartidos
Servicios web XML

Referencias de aplicaciones para UWP

La Plataforma universal de Windows (UWP) proporciona una plataforma de aplicaciones común para cada dispositivo que ejecuta Windows. Para obtener información sobre cómo crear una aplicación para UWP, consulta Tutorial: Creación de tu primera aplicación para la Plataforma universal de Windows en Visual Studio con XAML y C#.

Referencias de proyecto

Los proyectos de la Plataforma universal de Windows (UWP) pueden crear referencias a otros proyectos de UWP de la solución, o a proyectos o archivos binarios de Windows 8.1, siempre que estos proyectos no usen API que han quedado en desuso en Windows 10 y versiones posteriores. Para obtener más información, consulta Mover de Windows Runtime 8 a UWP.

Si decide migrar proyectos de Windows 8.1 a Windows 10 y versiones posteriores, consulte Portar, migrar y actualizar proyectos de Visual Studio.

Sugerencia

Para obtener información sobre cómo crear y compilar una nueva aplicación para UWP para Windows 10 y Windows 11, consulta Elegir una versión de UWP.

Referencias del SDK de extensión

Las aplicaciones de la Plataforma universal de Windows (UWP) de Visual Basic, C#, C++ y JavaScript pueden hacer referencia a SDK de extensión que tienen como destino Windows 8.1, siempre y cuando estos SDK de extensión no usen API que han quedado en desuso en Windows 10 y versiones posteriores. Comprueba el sitio del proveedor del SDK de extensión para averiguar si las aplicaciones para UWP pueden hacer referencia a ella.

Si determina que no se admite el SDK de extensión al que hace referencia la aplicación, debe realizar los pasos siguientes:

Examine el nombre del proyecto que está causando el error. La plataforma a la que se dirige el proyecto se indica entre paréntesis junto al nombre del proyecto. Por ejemplo, MyProjectName (Windows 8.1) significa que el proyecto MyProjectName tiene como destino la versión de la plataforma Windows 8.1.
Vaya al sitio del proveedor que posee el SDK de extensión no compatible e instale la versión del SDK de extensión con dependencias compatibles con la versión de la plataforma que el proyecto tiene como destino.

Nota:

Una manera de averiguar si un SDK de extensión tiene dependencias en otros SDK de extensión es buscando en el Administrador de referencias. Reinicie Visual Studio, cree un nuevo proyecto de aplicación para UWP de C# y, a continuación, haga clic con el botón derecho en el proyecto y seleccione Agregar referencia. Vaya a la pestaña Windows y, a continuación, a la sub pestaña Extensiones y seleccione el SDK de extensión. Examine el panel derecho en el Administrador de referencias. Si tiene dependencias, se mostrarán allí.

Importante

Si el proyecto tiene como destino Windows 10 específicamente, y el SDK de extensión instalado en el paso anterior tiene una dependencia del paquete en tiempo de ejecución de Microsoft Visual C++, la versión del paquete en tiempo de ejecución de Microsoft Visual C++ que es compatible con Windows 10 es v14.0 y se instala con Visual Studio.
Si el SDK de extensión que instaló en el paso anterior tiene dependencias en otros SDK de extensión, vaya a los sitios de los proveedores que poseen las dependencias y, a continuación, instale las versiones de estas dependencias que son compatibles con la versión de la plataforma que el proyecto tiene como destino.
Reinicie Visual Studio y abra la aplicación.
Haga clic con el botón derecho en el nodo Referencias o dependencias del proyecto que produjo el error y, a continuación, seleccione Agregar referencia.
Active la pestaña Windows y, a continuación, la subtab Extensiones , desactive las casillas de los SDK de extensión antiguos y, a continuación, active las casillas de los nuevos SDK de extensión. Selecciona Aceptar.

Agregar una referencia en tiempo de diseño

Al hacer una referencia a un ensamblado en el proyecto, Visual Studio busca el ensamblado en las siguientes ubicaciones:

Directorio del proyecto actual. (Puede encontrar estos ensamblados mediante la pestaña Examinar ).
Otros directorios de proyecto de la misma solución. (Puede encontrar estos ensamblados en la pestaña Proyectos ).

Nota:

Todos los proyectos contienen una referencia implícita a mscorlib.
Todos los proyectos contienen una referencia implícita a System.Core, incluso si System.Core se quita de la lista de referencias.
Los proyectos de Visual Basic contienen una referencia implícita a Microsoft.VisualBasic.

Referencias a componentes compartidos en tiempo de ejecución

En tiempo de ejecución, los componentes deben estar en la ruta de acceso de salida del proyecto o en la Caché de ensamblaje global (GAC). Si el proyecto contiene una referencia a un objeto que no está en una de estas ubicaciones, debe copiar la referencia a la ruta de acceso de salida del proyecto al compilar el proyecto. La CopyLocal propiedad indica si se debe realizar esta copia. Si el valor es True, la referencia se copia en el directorio del proyecto al compilar el proyecto. Si el valor es False, la referencia no se copia.

Si implementa una aplicación que contiene una referencia a un componente personalizado registrado en la GAC, el componente no se implementará con la aplicación, independientemente de la CopyLocal configuración. En versiones anteriores de Visual Studio, podría establecer la propiedad CopyLocal en una referencia para asegurar la implementación del ensamblado. Ahora, debe agregar manualmente el ensamblado a la carpeta \Bin. Esta acción pone bajo el examen todo el código personalizado, lo que reduce el riesgo de publicar código personalizado con el que no está familiarizado.

De forma predeterminada, la CopyLocal propiedad se establece en False si el ensamblado o componente está en la caché global de ensamblados o es un componente de marco. De lo contrario, el valor se establece en True. Las referencias de proyecto a proyecto siempre se establecen en True.

Hacer referencia a un proyecto o ensamblado que tiene como destino otra versión de .NET

Puede crear aplicaciones que hagan referencia a proyectos o ensamblados que tienen como destino una versión diferente de .NET. Por ejemplo, podría crear una aplicación destinada a .NET Framework 4.6, que haga referencia a un ensamblado destinado a .NET Framework 4.5. Si crea un proyecto destinado a una versión anterior de .NET, no puede establecer una referencia en ese proyecto a un proyecto o ensamblado que tenga como destino una versión más reciente.

Para obtener más información, consulte Framework targeting overview.

Referencias de proyecto a proyecto

Las referencias de proyecto a proyecto son referencias a proyectos que contienen ensamblados; puede agregar referencias de proyecto mediante la pestaña Proyectos del cuadro de diálogo Administrador de referencias. Visual Studio puede encontrar un ensamblado cuando se proporciona una ruta de acceso al proyecto.

Cuando tenga un proyecto que genere un ensamblado, debe hacer referencia al proyecto y no usar una referencia de archivo. La ventaja de una referencia de proyecto a proyecto es que crea una dependencia entre los proyectos del sistema de compilación. El proyecto dependiente se compila si ha cambiado desde la última vez que se creó el proyecto de referencia. Una referencia de archivo no crea una dependencia de compilación, por lo que es posible compilar el proyecto de referencia sin compilar el proyecto dependiente y la referencia puede quedar obsoleta. (Es decir, el proyecto puede hacer referencia a una versión compilada previamente del proyecto). Esto puede dar lugar a que se requieran varias versiones de un solo archivo DLL en el directorio bin , lo que no es posible. Cuando se produce este conflicto, aparece un mensaje, como "Advertencia: la dependencia 'file' del proyecto 'project' no se puede copiar en el directorio de ejecución porque sobrescribiría la referencia 'file'". Para obtener más información, consulte Solución de problemas de referencias interrumpidas y Cómo: Crear y quitar dependencias del proyecto.

Nota:

Se crea una referencia de archivo en lugar de una referencia de proyecto a proyecto si la versión de destino de .NET Framework de un proyecto es la versión 4.5 y la versión de destino del otro proyecto es la versión 2, 3, 3.5 o 4.0.

Referencias a proyectos compartidos

A diferencia de la mayoría de los otros tipos de proyecto, un proyecto compartido no tiene ninguna salida binaria. En su lugar, el código se compila en cada proyecto que hace referencia a él. Los proyectos compartidos permiten escribir código común al que hacen referencia muchos proyectos de aplicación diferentes. El código se compila como parte de cada proyecto de referencia y puede incluir directivas del compilador para ayudar a incorporar funcionalidades específicas de la plataforma en la base de código compartido. Agregue una referencia a un proyecto compartido en la pestaña Proyectos compartidos del cuadro de diálogo Administrador de referencias.

Referencias de archivo

Las referencias de archivo son referencias directas a ensamblados fuera del contexto de un proyecto de Visual Studio. Puede crearlos mediante la pestaña Examinar del cuadro de diálogo Administrador de referencias. Use una referencia de archivo cuando solo tenga un ensamblado o componente, y no el proyecto que lo crea como salida.

Compartir a través de