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

  • Artículo

Actualización: noviembre 2007

Nota:

El procedimiento para establecer la ruta de acceso de referencia para los proyectos de Visual C# es ligeramente diferente. En un proyecto de Visual Basic, haga clic en el botón Rutas de acceso de referencia para mostrar el cuadro de diálogo Agregar referencia. En un proyecto de Visual C#, use Rutas de acceso de referencia (Página, Diseñador de proyectos) (C#) del Diseñador de proyectos. Para obtener más información, consulte Cómo: Establecer la ruta de acceso de referencia (C#).

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

  • .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.

En el cuadro de diálogo Agregar referencia sólo se muestran los ensamblados de la carpeta de ensamblados públicos (Archivos de programa\Microsoft Visual Studio 9.0\Common7\IDE\Public Assemblies). Puede copiar sus propios ensamblados en la carpeta de ensamblados públicos o examinarlos directamente. Tenga en cuenta que no puede agregar referencias de la Caché de ensamblados global (GAC), ya que forma parte estrictamente del entorno de tiempo de ejecución.

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. También 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.

Si se implementa o copia una aplicación que contiene una referencia a un componente personalizado registrado en la GAC, 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 Referencias del proyecto.

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.

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 Cómo: Agregar y quitar referencias Web.

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.)

    • La carpeta de ensamblados públicos: Archivos de programa\Microsoft Visual Studio 9.0\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:

    Agregue una de las siguientes claves al Registro, donde <AssemblyLocation> es el directorio de los ensamblados que deberán aparecer en el cuadro de diálogo Agregar referencia; por ejemplo, C:\MyAssemblies\.

    [HKEY_CURRENT_USER\SOFTWARE\Microsoft\.NETFramework\<version>\AssemblyFoldersEx\MyAssemblies]@="<AssemblyLocation>"

    [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\<version>\AssemblyFoldersEx\MyAssemblies]@="<AssemblyLocation>"

    Nota:

    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.

    Invoque de nuevo el cuadro de diálogo Agregar referencia; los ensamblados deben aparecer en la ficha .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.

    Sugerencia:

    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.

    Sugerencia:

    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.

    Sugerencia:

    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, consulte Cómo: Quitar referencias no utilizadas (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.

    Sugerencia:

    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, consulte Cómo: Quitar referencias no utilizadas (Visual Basic).

Para establecer una ruta de acceso de 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 Rutas de acceso de referencia.

  4. En el campo Carpeta: del cuadro de diálogo Rutas de acceso de referencia, escriba la ruta de acceso completa de la carpeta que contiene los componentes.

  5. Haga clic en el botón Agregar carpeta y elija Aceptar.

    Nota:

    Cada vez que se abra el cuadro de diálogo Agregar referencia, se buscará únicamente en la carpeta especificada; no se buscará en las subcarpetas. Debe agregar una ruta de acceso diferente para cada subdirectorio en el que desee buscar.

Para establecer una ruta de acceso de 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, a continuación, seleccione Propiedades.

  2. En el Diseñador de proyectos, haga clic en la ficha Rutas de acceso de referencia.

  3. En el campo Carpeta, escriba la ruta de acceso completa de la carpeta que contiene los componentes.

  4. Haga clic en el botón Agregar carpeta y elija Aceptar.

    Nota:

    Cada vez que se abra el cuadro de diálogo Agregar referencia, se buscará únicamente en la carpeta especificada; no se buscará en las subcarpetas. Debe agregar una ruta de acceso diferente para cada subdirectorio en el que desee buscar.

Vea también

Tareas

Solucionar problemas de referencias rotas

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

Cómo: Quitar referencias no utilizadas (Visual Basic)

Cómo: Establecer la propiedad Copy Local de una referencia

Cómo: Agregar nuevos elementos de proyecto

Cómo: Agregar y quitar referencias Web

Conceptos

Referencias del proyecto

Referencias web en Visual Studio

Otros recursos

Administrar referencias

Hacer referencia a espacios de nombres y componentes