끊어진 참조 문제 해결Troubleshoot broken references

응용 프로그램에서 끊어진 참조를 사용하려고 하면 예외 오류가 생성됩니다.If your application attempts to use a broken reference, an exception error is generated. 참조된 구성 요소를 찾을 수 없는 것이 오류의 주된 원인이지만, 참조가 끊어진 것으로 간주되는 여러 상황이 있습니다.The inability to find the referenced component is the primary trigger for the error, but there are several situations in which a reference can be considered broken. 다음 목록에 이러한 경우가 나와 있습니다.These instances are shown in the following list:

  • 프로젝트의 참조 경로가 잘못되었거나 불완전합니다.The project's reference path is incorrect or incomplete.

  • 참조되는 파일이 삭제되었습니다.The file being referenced has been deleted.

  • 참조되는 파일의 이름이 바뀌었습니다.The file being referenced has been renamed.

  • 네트워크 연결 또는 인증에 실패했습니다.The network connection or authentication has failed.

  • 컴퓨터에 설치되지 않은 COM 구성 요소에 대한 참조입니다.The reference is to a COM component that is not installed on the computer.

    이러한 문제에 대한 해결 방법은 다음과 같습니다.The following are remedies to these problems.

참고

어셈블리의 파일이 프로젝트 파일의 절대 경로를 사용하여 참조됩니다.Files in assemblies are referenced with absolute paths in the project file. 따라서 복수 개발자 환경에서 작업하는 사용자는 로컬 환경에서 참조되는 어셈블리를 놓치고 있을 수 있습니다.Therefore, it is possible for users who work in a multideveloper environment to be missing a referenced assembly in their local environment. 이 오류를 피하려면 이러한 경우에 프로젝트 간 참조를 추가하는 것이 좋습니다.To avoid these errors, it is better in these cases to add project-to-project references. 자세한 내용은 어셈블리를 사용한 프로그래밍을 참조하세요.For more information, see Programming with Assemblies.

참조 경로가 잘못됨Reference path is incorrect

프로젝트가 여러 컴퓨터에서 공유될 경우 구성 요소가 각 컴퓨터에서 서로 다른 디렉터리에 있으면 일부 참조를 찾지 못할 수 있습니다.If projects are shared on different computers, some references might not be found when a component is located in a different directory on each computer. 참조는 구성 요소 파일 이름으로 저장됩니다(예: MyComponent).References are stored under the name of the component file (for example, MyComponent). 참조가 프로젝트에 추가되면 구성 요소 파일의 폴더 위치(예: C:\MyComponents\)가 ReferencePath 프로젝트 속성에 추가됩니다.When a reference is added to a project, the folder location of the component file (for example, C:\MyComponents\) is appended to the ReferencePath project property.

프로젝트가 열리면 참조 경로에서 디렉터리를 확인하여 이러한 참조된 구성 요소 파일을 찾으려고 합니다.When the project is opened, it attempts to locate these referenced component files by looking in the directories on the reference path. 구성 요소가 다른 디렉터리(예: D:\MyComponents\)에 저장된 컴퓨터에서 프로젝트가 열리면 참조를 찾을 수 없고 오류가 작업 목록에 표시됩니다.If the project is opened on a computer that stores the component in a different directory, such as D:\MyComponents\, the reference cannot be found and an error appears in the Task List.

이 문제를 해결하려면 끊어진 참조를 삭제하고 나서 [참조 추가] 대화 상자를 사용하여 바꿀 수 있습니다.To fix this problem, you can delete the broken reference and then replace it using the Add Reference dialog box. 또 다른 해결 방법은 프로젝트의 속성 페이지에서 참조 경로 항목을 사용하고 목록에서 폴더를 수정하여 올바른 위치를 가리키는 것입니다.Another solution is to use the Reference Path item in the project's property pages and modify the folders in the list to point to the correct locations. 참조 경로 속성은 각 컴퓨터에서 사용자별로 유지됩니다.The Reference Path property is persisted for each user on each computer. 따라서 참조 경로를 수정해도 프로젝트의 다른 사용자에게 영향을 미치지 않습니다.Therefore, modifying your reference path does not affect other users of the project.

프로젝트 간 참조에는 이러한 문제가 없습니다.Project-to-project references do not have these problems. 이런 이유로, 가능한 경우 파일 참조 대신 프로젝트 간 참조를 사용하세요.For this reason, use them instead of file references, if you can.

참조 경로를 수정하여 끊어진 프로젝트 문제를 해결하려면To fix a broken project reference by correcting the reference path

  1. 솔루션 탐색기에서 프로젝트 노드를 마우스 오른쪽 단추로 클릭하고 속성을 클릭합니다.In Solution Explorer, right-click your project node and click Properties.

  2. 프로젝트 디자이너가 표시됩니다.The Project Designer appears.

  3. Visual Basic을 사용할 경우 참조 페이지를 선택하고 참조 경로 단추를 클릭합니다.If you are using Visual Basic, select the References page and click the Reference Paths button. 참조 경로 대화 상자에서 참조할 항목이 포함된 폴더의 경로를 폴더 필드에 입력하고 폴더 추가 단추를 클릭합니다.In the Reference Paths dialog box, type the path of the folder that contains the item you want to reference in the Folder field, and then click the Add Folder button.

    또는-or-

    Visual C#을 사용할 경우 참조 경로 페이지를 선택합니다.If you are using Visual C#, select the Reference Paths page. 폴더 필드에 참조할 항목이 포함된 폴더의 경로를 입력하고 폴더 추가 단추를 클릭합니다.In the Folder field, type the path of the folder that contains the item you want to reference, and then click the Add Folder button.

참조된 파일이 삭제됨Referenced file has been deleted

참조되는 파일이 삭제되었고 더 이상 드라이브에 없을 수 있습니다.It is possible that the file being referenced has been deleted and no longer exists on the drive.

더 이상 드라이브에 없는 파일에 대한 끊어진 프로젝트 참조를 해결하려면To fix a broken project reference for a file that no longer exists on your drive

  • 참조를 삭제합니다.Delete the reference.

  • 참조가 컴퓨터의 또 다른 위치에 있으면 이 위치에서 참조를 읽으세요.If the reference exists in another location on your computer, read it from that location.

참조된 파일의 이름이 바뀜Referenced file has been renamed

참조되는 파일의 이름이 바뀌었을 수 있습니다.It is possible that the file being referenced has been renamed.

이름이 바뀐 파일에 대한 끊어진 참조를 해결하려면To fix a broken reference for a file that has been renamed

  • 참조를 삭제하고 나서 이름이 바뀐 파일에 참조를 추가합니다.Delete the reference, and then add a reference to the renamed file.

  • 참조가 컴퓨터의 또 다른 위치에 있으면 이 위치에서 참조를 읽어야 합니다.If the reference exists in another location on your computer, you have to read it in from that location.

네트워크 연결 또는 인증에 실패함Network connection or authentication has failed

파일에 액세스할 수 없는 경우 네트워크 연결 실패 또는 인증 실패 등의 다양한 원인이 있을 수 있습니다.There can be many possible causes for inaccessible files: a failed network connection or a failed authentication, for example. 각 원인에는 고유한 복구 방법이 있습니다. 예를 들어 필요한 리소스에 액세스하려면 로컬 관리자에게 문의해야 합니다.Each cause might have a unique means of recovery; for example, you might have to contact the local administrator for access to the required resources. 하지만 참조를 삭제하고 참조를 사용한 코드를 수정할 수도 있습니다.However, deleting the reference and fixing the code which used it is always an option.

COM 구성 요소가 컴퓨터에 설치되지 않음COM component is not installed on computer

사용자가 COM 구성 요소에 대한 참조를 추가했고 두 번째 사용자가 이 구성 요소가 설치되지 않은 컴퓨터에서 코드를 실행하려고 하면 두 번째 사용자에게 참조가 끊어졌다는 오류 메시지가 표시됩니다.If a user has added a reference to a COM component and a second user tries to run the code on a computer that does not have this component installed, the second user will receive an error that the reference is broken. 두 번째 컴퓨터에 구성 요소를 설치하면 오류가 수정됩니다.Installing the component on the second computer will correct the error. 프로젝트에서 COM 구성 요소 참조를 사용하는 방법에 대한 자세한 내용은 .NET Framework 응용 프로그램의 COM 상호 운용성을 참조하세요.For more information about how to use references to COM components in your projects, see COM Interoperability in .NET Framework Applications.

참고 항목See also

프로젝트 디자이너, 참조 페이지(Visual Basic)References Page, Project Designer (Visual Basic)