Solución de problemas de referencias rotas

Artículo
03/21/2023

Aplicable a: Visual Studio

Si la aplicación intenta usar una referencia rota, se genera un error de excepción. La razón principal del error es la incapacidad de encontrar el componente al que se hace referencia, pero hay varios escenarios en los que una referencia se considera rota y son:

La ruta de acceso de referencia del proyecto es incorrecta o está incompleta.
Se eliminó el archivo al que se hace referencia.
Se cambió el nombre del archivo al que se hace referencia.
Se ha producido un error en la conexión de red o la autenticación.
El componente COM al que se hace referencia no está instalado en el equipo.

En las secciones siguientes se proporcionan soluciones a estos escenarios.

Nota:

Se hace referencia a los archivos de los ensamblados con rutas de acceso absolutas en el archivo de proyecto. Por lo tanto, los usuarios que trabajan en un entorno de varios desarrolladores pueden encontrar que les falta un ensamblado al que se hace referencia en su entorno local. Para evitar estos errores, es mejor agregar referencias de proyecto a proyecto. Para obtener más información, vea Ensamblados en .NET.

La ruta de acceso de referencia es incorrecta o está incompleta

Si los proyectos se comparten en equipos diferentes, es posible que no se encuentren algunas referencias cuando un componente se encuentra en un directorio diferente. Las referencias se almacenan bajo el nombre del archivo de componente (por ejemplo, MyComponent). Al agregar una referencia a un proyecto, la ubicación de carpeta del archivo de componente (por ejemplo, C:\MyComponents) se anexa a la propiedad del proyecto ReferencePath .

Al abrir un proyecto, Visual Studio busca en los directorios de la ruta de acceso de referencia para intentar encontrar estos archivos de componentes. Si abre el proyecto en un equipo que almacena el componente en un directorio diferente, como D:\MyComponents, no se encontrará la referencia y aparecerá un error en la lista de tareas.

Para solucionar este problema, use uno de los métodos siguientes:

Elimine la referencia rota y reemplácela mediante el cuadro de diálogo Agregar referencia .
Use el elemento Ruta de acceso de referencia en las páginas de propiedades del proyecto. Modifique las carpetas de la lista para que apunten a las ubicaciones correctas. La propiedad Ruta de acceso de referencia se conserva para cada usuario de cada equipo. Por lo tanto, la modificación de la ruta de acceso de referencia no afecta a otros usuarios del proyecto.

Sugerencia

Las referencias de proyecto a proyecto no tienen estos problemas de referencia rotos. Por este motivo, use referencias de proyecto a proyecto en lugar de referencias de archivo, si puede.

Corrección de una referencia de proyecto interrumpida

Para corregir una referencia de proyecto interrumpida, corrija la ruta de acceso de referencia siguiendo estos pasos:

En Explorador de soluciones, haga clic con el botón derecho en el nodo del proyecto y, a continuación, seleccione Propiedades. Aparece el Designer Proyecto.
Si usa Visual Basic, seleccione la página Referencias y, a continuación, seleccione Rutas de acceso de referencia .
1. En el cuadro de diálogo Rutas de acceso de referencia, escriba la ruta de acceso de la carpeta que contiene el elemento al que desea hacer referencia en el campo Carpeta .
2. Seleccione Agregar carpeta.
Si usa C#, seleccione la página Rutas de acceso de referencia .
1. En el campo Carpeta , escriba la ruta de acceso de la carpeta que contiene el elemento al que desea hacer referencia.
2. Seleccione Agregar carpeta.

Se eliminó el archivo al que se hace referencia

Estas son dos opciones para corregir una referencia de proyecto interrumpida para un archivo eliminado que ya no existe en la unidad:

Elimine la referencia.
Si la referencia existe en otra ubicación del equipo, léela desde esa ubicación.

Se cambió el nombre del archivo al que se hace referencia

Estas son dos opciones para corregir una referencia rota para un archivo cuyo nombre se ha cambiado:

Elimine la referencia y agregue una referencia al archivo cuyo nombre se ha cambiado.
Si la referencia existe en otra ubicación del equipo, léela desde esa ubicación.

Error en la conexión de red o la autenticación

Puede haber muchas causas posibles de archivos inaccesibles. Por ejemplo, puede haber una conexión de red con errores o una autenticación errónea. Por el contrario, cada causa podría tener un medio único de recuperación. Por ejemplo, es posible que tenga que ponerse en contacto con el administrador local para acceder a los recursos necesarios. Sin embargo, eliminar la referencia y corregir el código que la usó siempre es una opción.

El componente COM al que se hace referencia no está instalado en el equipo

Si un usuario agrega una referencia a un componente COM y un segundo usuario intenta ejecutar el código en un equipo que no tiene instalado este componente, el segundo usuario recibe un error de referencia roto. La instalación del componente en el segundo equipo corrige el error. Para obtener más información sobre cómo usar referencias a componentes COM en los proyectos, vea Interoperabilidad COM en aplicaciones de .NET Framework.

Share via