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

Puede utilizar el cuadro de diálogo Administrador de referencias para agregar y administrar referencias a componentes que, Microsoft, u otra compañía desarrollaron.Si está desarrollando una aplicación de Tienda Windows, el proyecto automáticamente hace referencia a todo el Windows 8 SDK y .NET Framework.Si está desarrollando un proyecto de otro tipo, debe agregar estas referencias al proyecto manualmente.

Precaución
Puede agregar referencias en otros tipos de proyectos mediante el cuadro de diálogo Agregar referencia.Para obtener más información, vea Cómo: Agregar o quitar referencias utilizando el cuadro de diálogo Agregar referencia.

Agregar y quitar una referencia

Para agregar una referencia en un proyecto

1. En la barra de menú, elija Archivo, Abrir.

2. Navegue a la solución o proyecto.

3. En Explorador de soluciones, abra el menú contextual para el nodo Referencias y, a continuación Agregar referencia.

4. En el cuadro de diálogo Administrador de referencias, especifique las referencias para agregar, y elija el botón Aceptar.

Para quitar una referencia, abra el menú contextual, y elija Quitar.

Para agregar una referencia de proyecto de c++.

1. En la barra de menú, elija Archivo, Abrir.

2. Navegue a la solución o proyecto.

3. En Explorador de soluciones, abra el menú contextual para el nodo del proyecto y, a continuación References.

4. En el cuadro de diálogo Páginas de propiedades, elija el botón Agregar nueva referencia.

5. En el cuadro de diálogo Agregar referencia, especifique las referencias para agregar, y elija el botón Aceptar.

Para quitar una referencia, abra el menú contextual, y elija Quitar.

Administrador de referencias se abre y muestra las referencias disponible del grupo.El tipo de proyecto determina cuál de los grupos siguientes:

• Ensamblados, con los subgrupos de marco y las extensiones.

• Solución, con el subgrupo de los proyectos.

• Windows, con los subgrupos de base y extensions.Puede explorar las referencias en el SDK de Windows o la extensión SDK mediante Examinador de objetos.

• Navegación, con el subgrupo más recientes de.

Pestaña assemblies

La ficha ensamblados enumera todos los ensamblados de .NET Framework que están disponibles para hacer referencias.La ficha ensamblados no muestra ningún ensamblado de la caché global de ensamblados (GAC) porque los ensamblados en la GAC forman parte del entorno en tiempo de ejecución.Si se implementa o copia una aplicación que contenga una referencia a un ensamblado registrado en la GAC, no se implementará o copiará el ensamblado a la aplicación, independientemente de la configuración de la copia.Para obtener más información, vea Referencias de proyecto.

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

Todos los proyectos de escritorio contienen una referencia implícita a mscorlib.los proyectos de Visual Basic contienen una referencia implícita a Microsoft.VisualBasic.En Visual Studio 2012, todos los proyectos contienen una referencia implícita a System.Core, incluso si ha quitado de la lista de referencias.

Si ocurre un tipo de proyecto no los ensamblados de, la pestaña no aparecerá en el cuadro de diálogo Administrador de referencias.

La pestaña assemblies consta de dos sub- TABS:

1. Listas de marco todos los ensamblados que constituyen el marco de destino.

   • Los ensamblados anunciados están en el marco completo y se muestran en la lista de marco cuando el proyecto tiene como destino un perfil de.NET framework de destino.Los ensamblados anunciados son grises diferenciarlos de los ensamblados que existen en el perfil de proyecto.Por ejemplo, si un proyecto destinado a.NET Framework 4 client, la lista de marco muestra los ensamblados anunciados de .NET Framework 4.Cuando un usuario agrega un ensamblado de divulgación, notifica al usuario que, después de cerrar el cuadro de diálogo Administrador de referencias, el proyecto se cambiado a .NET Framework 4 y se agregará al ensamblado de divulgación.

   • Los proyectos para las aplicaciones de Tienda Windows contienen referencias a todos los ensamblados de .NET para aplicaciones de la Tienda Windows concreto de forma predeterminada en la creación del proyecto.En proyectos administrados, un nodo de solo lectura en la carpeta referencias Explorador de soluciones indica la referencia al marco completo.En consecuencia, la ficha del marco no mostrará los ensamblados cualquiera de los de marco y en su lugar no mostrará el siguiente mensaje: “Todos los ensamblados de.NET framework se hace referencia ya.El examinador de objetos para explorar las referencias en el marco”. Para los proyectos de escritorio, la ficha del marco enumera los ensamblados de.NET framework de destino, y el usuario debe agregar las referencias que la aplicación requiere.

2. Las extensiones enumeran todos los ensamblados que los proveedores externos de componentes y controles se han convertido para extender el marco de destino.Dependiendo del propósito de la aplicación de usuario, puede ser necesario estos ensamblados.

   • Las extensiones son rellenadas enumerando los ensamblados registrados en las ubicaciones siguientes:

     32-bit machine:
     HKEY_CURRENT_USER\SOFTWARE\Microsoft\[Target Framework Identifier]\v[Target Framework Version]\AssemblyFoldersEx\[UserComponentName]\@default=[Disk location of assemblies]
     HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\[Target Framework Identifier]\v[Target Framework Version]\AssemblyFoldersEx\[UserComponentName]\@default=[Disk location of assemblies]
     64-bit machine:
     HKEY_CURRENT_USER\SOFTWARE\Wow6432Node\Microsoft\[Target Framework Identifier]\v[Target Framework Version]\AssemblyFoldersEx\[UserComponentName]\@default=[Disk location of assemblies]
     HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\[Target Framework Identifier]\v[Target Framework Version]\AssemblyFoldersEx\[UserComponentName]\@default=[Disk location of assemblies]
     And older versions of the [Target Framework Identifier]
     

     Por ejemplo, si un proyecto tiene como destino.NET Framework 4 en un equipo de 32 bits, las extensiones enumerar los ensamblados registrados en el \microsoft\.netframework\v4.0\assemblyfoldersex\, \microsoft\.netframework\v3.5\assemblyfoldersex\, \microsoft\.netframework\v3.0\assemblyfoldersex\, \Microsoft\.NETFramework\v4.0\AssemblyFoldersEx\, \Microsoft\.NETFramework\v3.5\AssemblyFoldersEx\, \Microsoft\.NETFramework\v3.0\AssemblyFoldersEx\, and \Microsoft\.NETFramework\v2.0\AssemblyFoldersEx \microsoft\.netframework\v2.0\assemblyfoldersex \.

Pestaña COM

La pestaña COM muestra todos los componentes COM disponibles para hacer referencias.Si desea agregar una referencia a una DLL COM registrada que contiene un manifiesto interno, registro DLL primero.Si no, Visual Studio agrega la referencia de ensamblado como controles ActiveX en lugar de como una DLL nativa.

Si un tipo de proyecto no admite COM, la pestaña no aparecerá en el cuadro de diálogo Administrador de referencias.

Pestaña de la solución

La pestaña de la solución enumera todos los proyectos compatibles dentro de la solución actual, en el sub- TAB de los proyectos.

Un proyecto puede hacer referencia a otro proyecto destinado a una versión diferente de .NET Framework.Por ejemplo, podría crear un proyecto destinado a .NET Framework 4 pero que hace referencia a un ensamblado que se compila para .NET Framework 2.Sin embargo, el proyecto de .NET Framework 2 no puede hacer referencia a un proyecto de .NET Framework 4.Para obtener más información, vea Elegir versión de destino o perfil de .NET Framework específico.

Un proyecto destinado a .NET Framework 4 son incompatibles con un proyecto destinado a .NET Framework 4 Client Profile.

En Visual Studio 2012, una referencia de archivo en lugar de una referencia de proyecto se crea si un proyecto tiene como destino.NET Framework 4 y otro proyecto tiene como destino una versión anterior.

Un proyecto destinado a .NET para aplicaciones de la Tienda Windows no pueden agregar una referencia de proyecto a un proyecto destinado a.NET Framework y viceversa.

Pestaña de Windows

La pestaña de Windows muestra todo el SDK que es específico de las plataformas en las que ejecutan los sistemas operativos Windows.

Puede generar un archivo de WinMD en Visual Studio de dos maneras:

• Tienda Windows proyectos administrados de la aplicación: proyectos de aplicación de Tienda Windows pueden generar los binarios de WinMD estableciendo las propiedades de proyecto | Tipo de salida = archivo de WinMD.El nombre de archivo de WinMD debe ser el espacio de nombres de superconjunto de todos los espacios de nombres que existen dentro de.Por ejemplo, si un proyecto consta de los espacios de nombres A.B y A.B.C, los nombres posibles para su WinMD outputted son A.winmd y A.B.winmd.Si un usuario escribe propiedades de un proyecto | Propiedades del nombre del ensamblado o proyecto | Se genera el valor del espacio de nombres que es disjunto del conjunto de espacios de nombres en el proyecto o no hay ningún espacio de nombres de superconjunto dentro de un proyecto, una advertencia de compilación: “A.winmd” no es un nombre de archivo válido de .winmd para este ensamblado.Todos los tipos dentro de un archivo de metadatos de Windows deben existir en un espacio de nombres sub de nombre de archivo.Los tipos que no existen en un espacio de nombres sub de nombre de archivo no podrán encontrarse en tiempo de ejecución.En este ensamblado, espacio de nombres común más pequeño es “CSWSClassLibrary1”.Un proyecto de escritorio de Visual Basic o Visual c# puede utilizar sólo WinMDs que se representa mediante Windows 8 SDK, que se conocen como primero- entidad WinMDs, y no puede generar WinMDs.

• Tienda Windows proyectos nativo de la aplicación: Un archivo de WinMD nativo sólo contiene metadatos.La implementación existe en un archivo independiente de DLL.Se puede generar binarios nativos eligiendo la plantilla componente del proyecto en tiempo de ejecución de Windows en el cuadro de diálogo nuevo proyecto o por en un proyecto en blanco y modificando las propiedades del proyecto para generar un archivo de WinMD.Si el proyecto está compuesto de espacios de nombres disjuntos, un error de compilación indicará al usuario que combina los espacios de nombres o ejecute la herramienta de MSMerge.

La pestaña de Windows se compone de dos sub- TABS.

Subgrupo básico

La ficha básica muestra todos los WinMDs (para los elementos de WinRT) del SDK para la versión de Windows de destino.

proyectos de aplicación de Tienda Windows contienen referencias a todo el WinMDs en Windows 8 SDK de forma predeterminada en la creación del proyecto.En proyectos administrados, un nodo de solo lectura en la carpeta referencias Explorador de soluciones indica la referencia a Windows 8 completo SDK.En consecuencia, la ficha básica del administrador de referencia no mostrará los ensamblados cualquiera de Windows 8 SDK y en su lugar no muestra un mensaje: “Windows SDK se hace referencia ya.El examinador de objetos para explorar las referencias en el SDK de Windows”.

En los proyectos de escritorio la ficha básica no aparece de forma predeterminada.Puede agregar el tiempo de ejecución de Windows abriendo el menú contextual para el nodo del proyecto, elija Descargar el proyecto, agregando el siguiente fragmento, y la reapertura el proyecto (en el nodo de proyecto elija Volver a cargar el proyecto).Cuando se invoca el cuadro de diálogo Administrador de referencias, la ficha básica aparece.

  <PropertyGroup>
    <TargetPlatformVersion>8.0</TargetPlatformVersion>
  </PropertyGroup>

Asegúrese de comprobar el cuadro de Windows en esta ficha.A continuación debe poder utilizar los elementos de WinRT.

Subgrupo de extensiones

Las extensiones figura el usuario SDK que extienden la plataforma de destino de Windows.Esta pestaña aparece para los proyectos de aplicación de Tienda Windows únicamente.Los proyectos de escritorio no mostrará esta pestaña porque pueden utilizar solo los archivos de primero- entidad .winmd.

SDK es una colección de archivos que Visual Studio trate como un único componente.En la pestaña de extensiones, SDK que se aplica al proyecto de que el cuadro de diálogo Administrador de referencias se llamó se muestra como únicas entradas.Cuando se agrega a un proyecto, todo el contenido de SDK es consumido por Visual Studio para que el usuario no necesita tomar las medidas más otras para aprovechar el contenido de SDK en IntelliSense, cuadro de herramientas, diseñadores, explorador de objetos, compilación, implementación, depuración, y el paquete.Para obtener información sobre cómo mostrar SDK en la pestaña de extensiones, vea Cómo: Crear un kit de desarrollo de software.

[!NOTA]

Si un proyecto hace referencia SDK que depende de otro SDK, Visual Studio no consumirá segundo SDK a menos que el usuario agregue manualmente una referencia a segundo SDK.Cuando el usuario elige SDK en la pestaña Extensiones, el cuadro de diálogo Administrador de referencias ayuda a identificar las dependencias de SDK enumerando no solo el nombre y la versión de SDK pero también el nombre de cualquier dependencia de SDK en el panel de detalles.Si un usuario no observe las dependencias y no sólo agrega ese SDK, MSBuild pedirá al usuario agregar las dependencias.

Si un tipo de proyecto no admite Extensiones, la pestaña no aparece en el cuadro de diálogo Administrador de referencias.

Botón Examinar

Puede utilizar el botón examinar para buscar un componente en el sistema de archivos.

Un proyecto puede hacer referencia a un componente que tiene como destino una versión diferente de .NET Framework.Por ejemplo, podría crear una aplicación que tiene como destino.NET Framework client profile 4, que hace referencia a un componente que tiene como destino .NET Framework 2.Para obtener más información, vea Elegir versión de destino o perfil de .NET Framework específico.

Debe agregar referencias de archivo a resultados de otro proyecto de la misma solución, porque esta táctica puede producir errores de compilación.En su lugar, use la ficha Solución de las referencias de proyecto-a- proyecto desde el cuadro de diálogo para crear Administrador de referencias.Esta táctica crea el desarrollo en equipo más fácil habilitar 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.

No puede buscar SDK y agregarlo al proyecto.Puede examinar sólo en un archivo (por ejemplo, un ensamblado o un .winmd) y agregarlo al proyecto.

Al hacer una referencia de archivo a un WinMD, el diseño esperado es que [nombre de archivo] los .winmd, [nombre de archivo] todos los archivos .dll, y [nombre de archivo] de .pri están colocados junto a sí.Si hace referencia a un WinMD en los escenarios siguientes, en un conjunto de archivos o en el directorio de resultados del proyecto y, por consiguiente, compilación y los errores en tiempo de ejecución.

• Componente nativo: un proyecto nativo creará un WinMD para cada conjunto disjunto de espacios de nombres y de un archivo DLL que consiste en la implementación.El WinMDs tendrá nombres dispares.Al hacer referencia a este archivo componente nativo, MSBuild no reconocerá que el WinMDs disímil denominado crea un componente.Por consiguiente, solo [nombre de archivo] el archivo .dll del mismo nombre y [nombre de archivo] .winmd se copiará, y errores de tiempo de ejecución.Para solucionar este problema, cree una extensión SDK.Para obtener más información, vea Cómo: Crear un kit de desarrollo de software.

• Utilizar los controles: como mínimo, un control XAML consiste en [nombre de archivo] .winmd, [nombre de archivo] .dll, [nombre de archivo] .pri, [xamlname] .xaml, y a [imagename] .jpg.Cuando se compila el proyecto, los archivos de recursos asociados a la referencia de archivo no obtendrán copiará en el directorio de salida del proyecto, y sólo [nombre de archivo] .winmd, [nombre de archivo] .dll y [nombre de archivo] .pri se copiarán.Un error de compilación se registra para informar al usuario que faltan los recursos [xamlname] .xaml y [imagename] .jpg.Para funcionar correctamente, el usuario tendrá que manualmente copiar estos archivos de recursos en el directorio de salida del proyecto de compilación y depuración o tiempo de ejecución.Para solucionar este problema, cree una extensión SDK siguiendo los pasos de Cómo: Crear un kit de desarrollo de software o editar el archivo de proyecto para agregar la propiedad siguiente:

  <PropertyGroup>
  <GenerateLibraryOutput>True</GenerateLibraryOutput>
  </PropertyGroup>
  

  [!NOTA]

  Si agrega la propiedad, la compilación podría ejecutar más lento.

Recent

Los ensamblados, COM, Windows, y examine cada compatibilidad una ficha más recientes de, que muestra la lista de componentes agregados recientemente a proyectos.

Buscar

La barra de la búsqueda en el cuadro de diálogo Administrador de referencias funciona sobre la pestaña que está en el foco.Por ejemplo, si el usuario “system” en la barra de la búsqueda cuando la pestaña de la solución está en el foco, la búsqueda no devuelve ningún resultado a menos que la solución consta de un nombre de proyecto que contiene “system”.

Vea también

Tareas

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

Conceptos

Administrar referencias de proyecto.