어셈블리 바인딩 로그 뷰어(Fuslogvw.exe)

  • 아티클

어셈블리 바인딩 로그 뷰어는 어셈블리 바인딩에 대한 자세한 내용을 표시합니다. 이 정보를 검토하면 .NET Framework에서 런타임에 어셈블리를 찾지 못하는 이유를 진단할 수 있습니다. 이러한 오류는 일반적으로 어셈블리가 잘못된 위치에 배포되었거나 버전 번호 또는 culture가 일치하지 않기 때문에 일어납니다. 공용 언어 런타임의 어셈블리 찾기 오류는 일반적으로 응용 프로그램에서 TypeLoadException으로 나타납니다.

어셈블리 바인딩 로그의 내용을 보려면

뷰어에서는 실패한 각 어셈블리 바인딩의 엔트리를 표시하고 실패한 각각의 경우에 대해 바인딩을 시작한 응용 프로그램, 바인딩 대상 어셈블리(이름, 버전, culture, 공개 키 포함) 및 오류가 발생한 날짜와 시간 등을 설명합니다.

로그 위치 보기를 변경하려면

  1. 기본값 옵션 단추를 선택하여 모든 응용 프로그램 종류에 대한 바인딩 실패를 봅니다. 기본적으로 로그 항목은 디스크의 사용자별 디렉터리에서 wininet 캐시에 저장됩니다.

  2. 사용자 지정 옵션 단추를 선택하여 사용자 지정 디렉터리의 바인딩 오류를 봅니다. 로그 설정 대화 상자에서 유효한 디렉터리 이름으로 사용자 지정 로그 위치를 설정하여 런타임에서 로그를 저장할 사용자 지정 위치를 지정해야 합니다. 이 디렉터리는 런타임에 생성되는 파일만 포함해야 합니다. 실패하여 로그를 남길 수 있는 실행 파일이 들어 있으면 도구에서 실행 파일과 같은 이름으로 디렉터리를 만들려고 시도하므로 실패한 경우 로그를 남길 수 없습니다. 또한 로그 위치에서 실행 파일을 실행할 수 없습니다.

    참고

    사용자 지정 바인딩 위치보다 기본 바인딩 위치를 사용하는 것이 좋습니다. 런타임은 기본 바인딩 위치를 wininet 캐시에 저장하기 때문에 자동으로 이 위치를 비웁니다. 그러나 사용자 지정 바인딩 위치를 지정하는 경우에는 사용자가 직접 비워야 합니다.

특정 오류에 대한 자세한 내용을 보려면

  1. 뷰어에서 원하는 엔트리의 응용 프로그램 이름을 선택합니다.

  2. 로그 보기 단추를 클릭합니다. 또는 선택한 엔트리를 두 번 클릭할 수도 있습니다.

    다음과 같이 선택한 바인딩 오류에 대한 자세한 내용이 표시됩니다.

    • "파일을 찾을 수 없습니다." 또는 "버전이 일치하지 않습니다." 등 바인딩이 실패한 특정 원인

    • 이름, 응용 프로그램의 루트 디렉터리(AppBase) 및 개인 검색 경로(있는 경우)의 설명 등을 포함하여 바인딩을 시작한 응용 프로그램에 대한 정보

    • 도구에서 찾고 있는 어셈블리의 ID

    • 적용된 응용 프로그램, 게시자 또는 관리자 버전 정책 설명

    • 전역 어셈블리 캐시에 어셈블리가 있는지 여부

    • 검색하는 모든 URL 목록

다음 샘플 로그 엔트리는 실패한 어셈블리 바인딩에 대한 자세한 정보를 보여 줍니다.

** Assembly Binder Log Entry (3/5/2002 @ 12:54:20 PM) **

The operation failed.
Bind result: hr = 0x80070002. The system cannot find the file specified.

Assembly manager loaded from:  C:\WINNT\Microsoft.NET\Framework\v1.0.3705\fusion.dll
Running under executable  C:\Program Files\Microsoft.NET\FrameworkSDK\Samples\Tutorials\resourcesandlocalization\graphic\cs\graphicfailtest.exe
--- A detailed error log follows. 

=== Pre-bind state information ===
LOG: DisplayName = graphicfailtest.resources, Version=0.0.0.0, Culture=en-US, PublicKeyToken=null
 (Fully-specified)
LOG: Appbase = C:\Program Files\Microsoft.NET\FrameworkSDK\Samples\Tutorials\resourcesandlocalization\graphic\cs\
LOG: Initial PrivatePath = NULL
LOG: Dynamic Base = NULL
LOG: Cache Base = NULL
LOG: AppName = NULL
Calling assembly : graphicfailtest, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null.
===

LOG: Processing DEVPATH.
LOG: DEVPATH is not set. Falling through to regular bind.
LOG: Policy not being applied to reference at this time (private, custom, partial, or location-based assembly bind).
LOG: Post-policy reference: graphicfailtest.resources, Version=0.0.0.0, Culture=en-US, PublicKeyToken=null
LOG: Attempting download of new URL file:///C:/Program Files/Microsoft.NET/FrameworkSDK/Samples/Tutorials/resourcesandlocalization/graphic/cs/en-US/graphicfailtest.resources.DLL.
LOG: Attempting download of new URL file:///C:/Program Files/Microsoft.NET/FrameworkSDK/Samples/Tutorials/resourcesandlocalization/graphic/cs/en-US/graphicfailtest.resources/graphicfailtest.resources.DLL.
LOG: Attempting download of new URL file:///C:/Program Files/Microsoft.NET/FrameworkSDK/Samples/Tutorials/resourcesandlocalization/graphic/cs/en-US/graphicfailtest.resources.EXE.
LOG: Attempting download of new URL file:///C:/Program Files/Microsoft.NET/FrameworkSDK/Samples/Tutorials/resourcesandlocalization/graphic/cs/en-US/graphicfailtest.resources/graphicfailtest.resources.EXE.
LOG: All probing URLs attempted and failed.

로그에서 단일 엔트리를 삭제하려면

  1. 뷰어에서 엔트리를 선택합니다.

  2. 엔트리 삭제 단추를 클릭합니다.

로그에서 모든 엔트리를 삭제하려면

  • 모두 삭제 단추를 클릭합니다.

사용자 인터페이스를 새로 고치려면

  • 새로 고침 단추를 클릭합니다. 뷰어는 실행 중인 동안에는 새 로그 엔트리를 자동으로 검색하지 않습니다. 새 엔트리를 표시하려면 새로 고침 단추를 사용해야 합니다.

로그 설정을 변경하려면

  • 설정 단추를 클릭하여 로그 설정 대화 상자를 엽니다.

정보 상자를 보려면

  • 정보 단추를 클릭합니다.

로그 설정 대화 상자

로그 설정 대화 상자를 사용하여 다음 작업을 수행할 수 있습니다.

로깅을 사용하지 않으려면

  • 로그 사용 안 함 옵션 단추를 선택합니다. 이 옵션은 기본적으로 선택되어 있습니다.

예외에 어셈블리 바인딩을 기록하려면

  • 예외 텍스트로 기록 옵션 단추를 선택합니다.

    도메인 중립적으로 로드되는 어셈블리에 대한 중요 사항을 참조하십시오.

어셈블리 바인딩 실패를 기록하려면

  • 디스크에 바인드 실패 기록 옵션 단추를 선택합니다.

    도메인 중립적으로 로드되는 어셈블리에 대한 중요 사항을 참조하십시오.

모든 어셈블리 바인딩을 기록하려면

  • 디스크에 모든 바인드 기록 옵션 단추를 선택합니다.

    도메인 중립적으로 로드되는 어셈블리에 대한 중요 사항을 참조하십시오.

중요

예를 들어, LoaderOptimization 속성을 System.LoaderOptimization.MultiDomain 또는 System.LoaderOptimization.MultiDomainHost로 설정하여 어셈블리가 도메인 중립적으로 로드되는 경우 로깅을 설정하면 경우에 따라 메모리가 누수될 수 있습니다. 도메인 중립 모듈이 응용 프로그램 도메인에 로드되었을 때 로그 엔트리가 만들어지고 나중에 응용 프로그램 도메인이 언로드되면 이러한 누수가 발생할 수 있습니다. 프로세스가 끝날 때까지는 로그 엔트리가 해제되지 않을 수도 있습니다. 로깅이 자동으로 설정되는 디버거도 있습니다.

사용자 지정 로그 경로를 사용하려면

  1. 사용자 지정 로그 경로 사용 옵션 단추를 선택합니다.

  2. 사용자 지정 로그 경로 입력란에 경로를 입력합니다.

참고

어셈블리 바인딩 로그 뷰어(Fuslogvw.exe)에서는 IE(Internet Explorer) 캐시를 사용하여 바인딩 로그를 저장합니다. 가끔 나타나는 IE 캐시 손상으로 인해 어셈블리 바인딩 로그 뷰어(Fuslogvw.exe)에서는 보기 창에 새 바인딩 로그를 표시하지 않을 수도 있습니다. 이 손상으로 인해 .NET 바인딩 인프라(Fusion)는 바인딩 로그에 쓰거나 바인딩 로그에서 읽을 수 없습니다. 사용자 지정 로그 경로를 사용하는 경우에는 이 문제가 발생하지 않습니다. 손상을 해결하고 Fusion이 바인딩 로그를 다시 표시하도록 하려면 IE 옵션 대화 상자 내에서 임시 인터넷 파일을 삭제하여 IE 캐시를 지웁니다.

관리되지 않는 응용 프로그램에서 IHostAssemblyManager 및 IHostAssemblyStore 인터페이스를 구현하여 공용 언어 런타임을 호스팅하는 경우 로그 엔트리를 wininet 캐시에 저장할 수 없습니다. 이러한 인터페이스를 구현하는 사용자 지정 호스트에 대한 로그 엔트리를 보려면 대체 로그 경로를 지정해야 합니다.

참고 항목

참조

.NET Framework 도구
TypeLoadException Class
SDK 명령 프롬프트

개념

전역 어셈블리 캐시
런타임에서 어셈블리를 찾는 방법