Solucionar problemas de referencias rotas
Se aplica 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 interrumpida y son:
- La ruta de acceso de referencia del proyecto es incorrecta o incompleta.
- Se eliminó el archivo al que se hace referencia.
- Se ha cambiado el nombre del archivo al que se hace referencia.
- Error en la conexión de red o 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 mediante rutas de acceso absolutas en el archivo del proyecto. Por lo tanto, los usuarios que trabajan en un entorno de varios desarrolladores pueden detectar que faltan un ensamblado al que se hace referencia en su entorno local. Para evitar estos errores, en estos casos es mejor agregar referencias entre proyectos. Para obtener más información, consulte Ensamblados de .NET.
La ruta de acceso de referencia es incorrecta o incompleta
Si los proyectos se comparten en equipos diferentes, es posible que algunas referencias no se encuentren cuando un componente se encuentra en un directorio diferente. Las referencias se almacenan con el nombre del archivo de componente (por ejemplo, MyComponent). Al agregar una referencia a un proyecto, la ubicación de la 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 probar y buscar 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 corregirlo, use uno de los siguientes métodos:
- Elimine la referencia interrumpida y, a continuación, 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 Reference Path se guarda para cada usuario en cada equipo. Por tanto, si modifica la ruta de acceso de referencia, esto 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 rota, 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 seleccione Propiedades. Aparece el Diseñador de proyectos.
- Si usa Visual Basic, seleccione la página Referencias y, a continuación, seleccione Rutas de acceso de referencia.
- 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 .
- Seleccione Agregar carpeta.
- Si usa C#, seleccione la página Rutas de acceso de referencia.
- En el campo Carpeta , escriba la ruta de acceso de la carpeta que contiene el elemento al que desea hacer referencia.
- Seleccione Agregar carpeta.
Se eliminó el archivo al que se hace referencia
Estas son dos opciones para corregir una referencia de proyecto rota de un archivo eliminado que ya no existe en la unidad:
- Elimine la referencia.
- Si la referencia existe en otra ubicación del equipo, léala desde esa ubicación.
Se ha cambiado el nombre del archivo al que se hace referencia
Estas son dos opciones para corregir una referencia rota de un archivo cuyo nombre se ha cambiado:
- Elimine la referencia y agregue una referencia al archivo cuyo nombre ha cambiado.
- Si la referencia existe en otra ubicación del equipo, léala desde esa ubicación.
Se ha producido un error en la conexión de red o en la autenticación
Puede haber muchas causas posibles de archivos inaccesibles. Por ejemplo, podría haber una conexión de red con errores o una autenticación con errores. Por el contrario, cada causa puede tener un único medio de recuperación. Por ejemplo, es posible que tenga que ponerse en contacto con el administrador local para acceder a los recursos necesarios. No obstante, siempre hay la opción de eliminar la referencia y corregir el código en el que se usaba esa referencia.
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. Si se instala el componente en el segundo equipo, se corregirá el error. Para obtener más información sobre cómo usar referencias a componentes COM en los proyectos, consulte Interoperabilidad COM en aplicaciones .NET Framework.