Fuslogvw.exe (Podgląd dziennika powiązań zasobów)

  • Artykuł

Podgląd dziennika powiązań zestawów wyświetla szczegóły dotyczące powiązań zestawu. Te informacje pomagają zdiagnozować, dlaczego .NET Framework nie może zlokalizować zestawu w czasie wykonywania. Te błędy są zazwyczaj wynikiem wdrożenia zestawu w nieprawidłowej lokalizacji, obrazu macierzystego, który przestał być prawidłowy lub niezgodności numerów wersji lub kultur. Błąd środowiska uruchomieniowego języka wspólnego podczas lokalizowania zestawu jest zwykle wyświetlany jako element TypeLoadException w aplikacji.

Ważne

Program fuslogvw.exe musi być uruchomione z uprawnieniami administratora.

To narzędzie jest instalowane automatycznie z programem Visual Studio. Aby uruchomić to narzędzie, użyj wiersza polecenia dla deweloperów programu Visual Studio lub programu Visual Studio Developer PowerShell z poświadczeniami administratora.

W wierszu polecenia wprowadź następujące polecenie:

fuslogvw

Przeglądarka wyświetla wpis dla każdego nieudanego powiązania zestawu. Dla każdego błędu przeglądarka opisuje następujące elementy:

  • aplikacja, która zainicjowała powiązanie
  • zestaw, dla których znajduje się powiązanie, łącznie z nazwą, wersją, kulturą i kluczem publicznym
  • data i godzina niepowodzenia

Zadanie

Zmienianie widoku lokalizacji dziennika

  1. Wybierz przycisk Opcji Domyślne, aby wyświetlić błędy powiązań dla wszystkich typów aplikacji. Domyślnie wpisy dziennika są przechowywane na dysku w katalogach użytkowników, w pamięci podręcznej wininet.

  2. Wybierz przycisk Opcji Niestandardowe , aby wyświetlić błędy powiązań w określonym katalogu niestandardowym. Należy określić lokalizację niestandardową, w której środowisko uruchomieniowe ma przechowywać dzienniki, ustawiając niestandardową lokalizację dziennika w oknie dialogowym Ustawienia dziennika na prawidłową nazwę katalogu. Ten katalog powinien być pusty i zawierać tylko pliki, które generuje środowisko uruchomieniowe. Jeśli zawiera plik wykonywalny, który generuje błąd, który ma zostać zapisany, błąd nie zostanie zapisany, ponieważ narzędzie spróbuje utworzyć katalog o takiej samej nazwie jak plik wykonywalny. Ponadto próba uruchomienia pliku wykonywalnego z lokalizacji dziennika nie powiedzie się.

    Uwaga

    Domyślna lokalizacja powiązania jest preferowana nad niestandardową lokalizacją powiązania. Środowisko uruchomieniowe przechowuje domyślną lokalizację powiązania w pamięci podręcznej wininet, a zatem automatycznie je czyści. Jeśli określisz niestandardową lokalizację powiązania, ponosisz odpowiedzialność za jej wyczyszczenie.

Wyświetlanie szczegółów dotyczących określonego błędu

  1. Wybierz nazwę aplikacji dla żądnego wpisu w przeglądarce.

  2. Kliknij przycisk Wyświetl dziennik . Można także kliknąć dwukrotnie wybrany wpis.

    W narzędziu są wyświetlane następujące szczegółowe informacje o błędzie wybranego powiązania:

    • Konkretna przyczyna niepowodzenia powiązania, taka jak „nie odnaleziono pliku” lub „niezgodność wersji”.

    • Informacje o aplikacji, która zainicjowała powiązanie, w tym jej nazwa, katalog główny aplikacji (AppBase) i opis prywatnej ścieżki wyszukiwania, jeśli taka istnieje.

    • Tożsamość zestawu, którego szuka narzędzie.

    • Opis dowolnych zastosowanych polityk wersji Aplikacji, Wydawcy lub Administratora.

    • Czy zestaw został znaleziony w globalnej pamięci podręcznej zestawów.

    • Lista wszystkich badających adresów URL.

Następujący przykładowy wpis dziennika zawiera szczegółowe informacje na temat nieudanych powiązań zestawu.

*** Assembly Binder Log Entry  (3/5/2007 @ 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\v2.0.50727\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/graphicfailtest.resources.DLL.
LOG: Attempting download of new URL file:///C:/Program Files/Microsoft.NET/FrameworkSDK/Samples/Tutorials/resourcesandlocalization/graphic/cs/graphicfailtest.resources/graphicfailtest.resources.DLL.
LOG: Attempting download of new URL file:///C:/Program Files/Microsoft.NET/FrameworkSDK/Samples/Tutorials/resourcesandlocalization/graphic/cs/graphicfailtest.resources.EXE.
LOG: Attempting download of new URL file:///C:/Program Files/Microsoft.NET/FrameworkSDK/Samples/Tutorials/resourcesandlocalization/graphic/cs/graphicfailtest.resources/graphicfailtest.resources.EXE.
LOG: All probing URLs attempted and failed.

Usuwanie wpisów

Aby usunąć pojedynczy wpis z dziennika:

  1. Wybierz wpis w przeglądarce.

  2. Kliknij przycisk Usuń wpis .

Aby usunąć wszystkie wpisy z dziennika:

  • Kliknij przycisk Usuń wszystko .

Odświeżanie interfejsu użytkownika

  • Kliknij przycisk Odśwież . Przeglądarka nie wykrywa automatycznie nowych wpisów dziennika, kiedy jest uruchomiona. Aby je wyświetlić, należy użyć przycisku Odśwież .

Zmienianie ustawień dziennika

Kliknij przycisk Ustawienia , aby otworzyć okno dialogowe Ustawienia dziennika .

Wyświetlanie okna dialogowego Informacje

Kliknij przycisk Informacje .

Tworzenie powiązań dzienników dla obrazów natywnych

Domyślnie Fuslogvw.exe rejestruje normalne żądania powiązania zestawów. Alternatywnie można rejestrować powiązania zestawów dla obrazów natywnych, które zostały utworzone przy użyciu Ngen.exe (Generator obrazów natywnych).

Powiązania zestawu dziennika dla obrazów natywnych

  • W grupie Kategorie dzienników wybierz przycisk Opcji Obrazy natywne .

Następujący dziennik pokazuje błąd spowodowany przez zależność, która nie istniała, kiedy obraz macierzysty został utworzony dla aplikacji. Jeżeli zależności w czasie wykonywania różnią się od zależności po uruchomieniu Ngen.exe, powiązanie z obrazem macierzystym jest niedozwolone.

*** Assembly Binder Log Entry  (12/8/2006 @ 5:22:07 PM) ***

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

Assembly manager loaded from:  E:\Windows\Microsoft.NET\Framework64\v2.0.50727\mscorwks.dll
Running under executable  E:\test\App.exe
--- A detailed error log follows.

LOG: Start binding of native image App, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null.
LOG: IL assembly loaded from E:\test\App.exe.
LOG: Start validating native image App, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null.
LOG: Start validating all the dependencies.
LOG: [Level 1]Start validating native image dependency mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089.
LOG: Dependency evaluation succeeded.
LOG: [Level 1]Start validating IL dependency b, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null.
WRN: Dependency assembly was not found at ngen time, but is found at binding time. Disallow using this native image.
WRN: No matching native image found.
LOG: Bind to native image assembly did not succeed. Use IL image.

Następujący dziennik wyświetla błąd powiązania obrazu macierzystego, który wystąpił, ponieważ ustawienia zabezpieczeń na komputerze, gdy aplikacja została uruchomiona, różniły się od ustawień zabezpieczeń w momencie utworzenia obrazu macierzystego.

*** Assembly Binder Log Entry  (12/8/2006 @ 5:29:09 PM) ***

The operation failed.
Bind result: hr = 0x80004005. Unspecified error

Assembly manager loaded from:  E:\Windows\Microsoft.NET\Framework64\v2.0.50727\mscorwks.dll
Running under executable  E:\test\Application101622.exe
--- A detailed error log follows.

LOG: Start binding of native image Application101622, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null.
LOG: IL assembly loaded from E:\test\Application101622.exe.
LOG: Start validating native image Application101622, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null.
LOG: Start validating all the dependencies.
LOG: [Level 1]Start validating native image dependency mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089.
LOG: Dependency evaluation succeeded.
LOG: [Level 1]Start validating IL dependency Dependency101622, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null.
LOG: Dependency evaluation succeeded.
LOG: Validation of dependencies succeeded.
LOG: Start loading all the dependencies into load context.
LOG: Loading of dependencies succeeded.
LOG: Bind to native image succeeded.
Native image has correct version information.
Attempting to use native image E:\Windows\assembly\NativeImages_v2.0.50727_64\Application101622\1ac7fadabec4f72575d807501e9fdc72\Application101622.ni.exe.
Rejecting native image because it failed the security check. The assembly's permissions must have changed since the time it was ngenned, or it is running with a different security context.
Discarding native image.

Okno dialogowe Ustawienia dziennika

Możesz użyć okna dialogowego Ustawienia dziennika , aby wykonać następujące akcje.

Aby wyłączyć rejestrowanie

  • Wybierz przycisk opcji Log disabled (Dziennik wyłączony ). Należy zauważyć, że ta opcja jest domyślnie zaznaczona.

Aby rejestrować powiązania zestawu w wyjątkach

  • Wybierz przycisk opcji Zaloguj się w tekście wyjątku . Tylko najmniej szczegółowe informacje dziennika łączenia są rejestrowane w tekście wyjątku. Aby wyświetlić pełne informacje, użyj jednego z innych ustawień.

    Zobacz Ważne informacje dotyczące zestawów, które są ładowane, jako niezależne od domeny.

Aby rejestrować błędy powiązania zestawów

  • Wybierz przycisk Opcji Log bind failures to disk (Rejestrowanie niepowodzeń powiązania z dyskiem ).

    Zobacz Ważne informacje dotyczące zestawów, które są ładowane, jako niezależne od domeny.

Aby rejestrować wszystkie powiązania zestawów

  • Wybierz przycisk Opcji Rejestruj wszystkie powiązania z dyskiem .

    Zobacz Ważne informacje dotyczące zestawów, które są ładowane, jako niezależne od domeny.

Ważne

Gdy zestaw jest ładowany jako neutralny dla domeny, na przykład przez ustawienie LoaderOptimization właściwości na LoaderOptimization.MultiDomain lub LoaderOptimization.MultiDomainHost, włączenie rejestrowania może spowodować przeciek pamięci w niektórych przypadkach. Może się to zdarzyć, jeśli wpis dziennika jest dodawany, gdy moduł niezależny od domeny jest ładowany do domeny aplikacji, a później domena aplikacji jest zwalniana. Wpis dziennika nie może być zwolniony do czasu zakończenia procesu. Niektóre debugery włączają rejestrowanie automatycznie.

Aby włączyć niestandardową ścieżkę dziennika

  1. Wybierz przycisk Włącz niestandardową ścieżkę dziennika .

  2. Wprowadź ścieżkę w polu tekstowym Niestandardowa ścieżka dziennika .

Uwaga

Przeglądarka dziennika powiązań zestawów (Fuslogvw.exe) używa internetowej pamięci podręcznej plików do przechowywania dziennika powiązań. Z powodu sporadycznych uszkodzeń w pamięci podręcznej przeglądarka dziennika powiązań zestawów (Fuslogvw.exe) może czasami przestać wyświetlać nowe dzienniki powiązań w oknie wyświetlania. W wyniku tego uszkodzenia infrastruktura powiązań .NET (fusion) nie może zapisywać w dzienniku powiązań ani z niego odczytywać. (Ten problem nie występuje, jeśli używasz niestandardowej ścieżki dziennika). Aby naprawić uszkodzenie i umożliwić ponowne wyświetlanie dzienników powiązań, wyczyść pamięć podręczną plików internetowych, usuwając tymczasowe pliki internetowe z sekcji Historia przeglądania we właściwościach internetowych.

Jeśli niezarządzana aplikacja hostuje środowisko uruchomieniowe języka wspólnego przez zaimplementowanie IHostAssemblyManager interfejsów i IHostAssemblyStore , wpisy dziennika nie mogą być przechowywane w pamięci podręcznej wininet. Aby wyświetlić wpisy dziennika dla hostów niestandardowych, które implementują te interfejsy, należy określić alternatywną ścieżkę dziennika.

Aby włączyć rejestrowanie dla aplikacji działających w kontenerze aplikacji systemu Windows

  1. Należy włączyć niestandardową ścieżkę dziennika, jak opisano w poprzedniej procedurze. Domyślnie aplikacje, które są uruchomione w kontenerze aplikacji systemu Windows mają ograniczony dostęp do dysku twardego. Katalog, który zostanie określony, będzie miał dostęp do odczytu i zapisu dla wszystkich aplikacji z kontenera aplikacji.

  2. Zaznacz pole wyboru Włącz rejestrowanie immersyjne .

    Uwaga

    To pole jest włączone tylko w systemie Windows 8 lub nowszym.

Zobacz też