程序集绑定日志查看器 (Fuslogvw.exe)

程序集绑定日志查看器显示程序集绑定的详细信息。这些信息有助于您诊断 .NET Framework 无法在运行时找到程序集的原因。这些失败通常是由于程序集部署到错误位置或者版本号或区域性不匹配造成的。如果公共语言运行库未能找到程序集,则通常会在您的应用程序中表现为 TypeLoadException

查看程序集绑定日志的内容

查看器将为每次失败的程序集绑定显示一项。对于每次失败,查看器会描述启动该绑定的应用程序,绑定所针对的程序集(包括名称、版本、区域性和公钥),以及失败的日期和时间。

更改日志位置视图

  1. 选择**“Default”**选项按钮可以查看所有应用程序类型的绑定失败。默认情况下,日志项存储在磁盘上 wininet 缓存中基于用户的目录中。

  2. 选择**“Custom”选项按钮可以在您指定的自定义目录中查看绑定失败信息。必须指定您希望运行库存储日志的自定义位置,方法是在“Log Settings”**对话框中设置自定义日志位置,将其设置为有效的目录名。此目录应是干净的,并且仅包含运行库所生成的文件。如果该目录中包含了一个会生成可被记录下来的失败的可执行文件,则该失败将不会被记录下来,因为此工具试图创建一个与该可执行文件同名的目录。此外,试图从日志位置运行可执行文件时也会失败。

    备注

    默认的绑定位置优于自定义绑定位置。运行库将默认绑定位置存储在 wininet 缓存中,因而可以自动清除该位置。如果您指定了自定义绑定位置,则需要自行将其清除。

查看有关特定失败的详细信息

  1. 在查看器中选择所需项的应用程序名称。

  2. 单击**“View Log”**按钮。或者,可以双击所选项。

    该工具将显示以下有关所选绑定失败的详细信息:

    • 绑定失败的具体原因,例如“未找到文件”或“版本不匹配”。

    • 与启动该绑定的应用程序有关的信息,包括其名称、应用程序的根目录 (AppBase) 以及专用搜索路径的说明(如果具有此类路径)。

    • 该工具正查找的程序集的标识。

    • 已经应用的任何应用程序、发行者或管理员版本策略的说明。

    • 是否已在全局程序集缓存中找到了程序集。

    • 所有正探测的 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. 单击**“Delete Entry”**按钮。

从日志中删除所有项

  • 单击**“Delete All”**按钮。

刷新用户界面

  • 单击**“刷新”按钮。查看器在其运行时不自动检测新的日志项。您必须使用“Refresh”**按钮来显示它们。

更改日志设置

  • 单击**“Settings”按钮打开“Log Settings”**对话框。

查看“About”对话框

  • 单击**“About”**按钮。

“Log Settings”对话框

可以使用**“Log Settings”**对话框执行下列操作。

禁用日志记录

  • 选择**“Log disabled”**选项按钮。注意,默认情况下此选项处于选中状态。

在异常中记录程序集绑定

  • 选择**“Log in exception text”**选项按钮。

    请参见有关以非特定域方式加载的程序集的“重要事项”说明。

记录程序集绑定失败

  • 选择**“Log bind failures to disk”**选项按钮。

    请参见有关以非特定域方式加载的程序集的“重要事项”说明。

记录所有程序集绑定

  • 选择**“Log all binds to disk”**选项按钮。

    请参见有关以非特定域方式加载的程序集的“重要事项”说明。

Note要点

当程序集以非特定域方式加载时(例如,将 LoaderOptimization 属性设置为 System.LoaderOptimization.MultiDomainSystem.LoaderOptimization.MultiDomainHost),打开日志记录可能会在某些情况下泄露内存。如果在将非特定于域的模块载入一个应用程序域时记录日志条目,随后又卸载该应用程序域,就可能发生内存泄露。在进程结束前可能将不会释放该日志条目。一些调试器会自动打开日志记录。

启用自定义日志路径

  1. 选择**“Enable custom log path”**选项按钮。

  2. 在**“Custom log path”**文本框中输入路径。

备注

程序集绑定日志查看器 (Fuslogvw.exe) 使用 Internet Explorer (IE) 缓存来存储其绑定日志。由于 IE 缓存中偶尔会出现损坏,因此 程序集绑定日志查看器 (Fuslogvw.exe) 有时会停止在查看窗口中显示新的绑定日志。受此损坏的影响,.NET 绑定基础结构(合成)将无法写入或读取绑定日志。(如果使用自定义日志路径,则不会遇到此问题。)若要修复损坏的数据,并允许合成再次显示绑定日志,请在 IE 的“Internet 选项”对话框中删除临时的 Internet 文件,以清除 IE 缓存。

如果非托管应用程序通过实现 IHostAssemblyManagerIHostAssemblyStore 接口成为公共语言运行库的宿主,则不能将日志条目存储在 wininet 缓存中。若要查看实现这些接口的自定义宿主的日志条目,必须指定替代日志路径。

请参见

参考

.NET Framework 工具
TypeLoadException Class
SDK 命令提示

概念

全局程序集缓存
运行库如何定位程序集