SecAnnotate.exe（.NET 安全批注器工具）

  • 项目

更新：2011 年 4 月

.NET 安全 Annotator 工具 (SecAnnotate.exe) 是标识一个或多个程序集 SecurityCritical 和 SecuritySafeCritical 部分的命令行应用程序。

安全 Annotator 是一个 Visual Studio 扩展，它提供一个 SecAnnotate.exe 的图形用户界面，使您能够从 Visual Studio 中运行该工具。

安装 Visual Studio 和 Windows SDK 时会自动安装此工具。 要运行工具，我们建议您使用 Visual Studio 命令提示符或 Windows SDK 命令提示符（也称 CMD Shell）。 您可以使用这些实用程序轻松运行工具，而不需要导航到安装文件夹。 有关更多信息，请参见 Visual Studio 和 Windows SDK 命令提示。

  • 如果您的计算机上已安装了 Visual Studio：在任务栏上依次单击 Start、All Programs、Visual Studio、Visual Studio Tools、Visual Studio Command Prompt。

    - 或 -

    如果您的计算机上已安装了 Windows SDK：在任务栏上依次单击 Start、All Programs、Windows SDK 文件夹和 Command Prompt（或CMD Shell)。

  • 在命令提示符下，键入以下内容，其中，parameters 在下面的部分中进行了描述，assemblies 包含一个或多个由空格分隔的程序集名称：

SecAnnotate.exe [parameters] [assemblies]

参数

选项

说明

/a

或

/showstatistics

显示和正在分析的程序集中的透明度使用有关的统计信息。

/d:目录

或

/referencedir:目录

指定注释的过程中搜索依赖程序集的目录。

/i

或

/includesignatures

包括批注报告文件中的扩展签名信息。

/n

或

/nogac

禁止搜索全局程序集缓存中引用的程序集。

/o:output.xml

或

/out:output.xml

指定输出注释文件。

/p:maxpasses

或

/maximumpasses:maxpasses

指定停止生成新注释前，要在程序集上传递的最大注释数。

/q

或

/quiet

指定安静模式，该模式下的该 annotator 不会输出状态消息；将输出仅错误的信息。

/r:assembly

或

/referenceassembly:assembly

批注的过程中解析依赖程序集时，请包括指定的程序集。 引用程序集得到的优先级高于在引用路径中找到的程序集。

/s:规则名称

或

/suppressrule:规则名称

禁止在输入程序集上运行指定的透明度规则。

/t

或

/forcetransparent

强制 Annotator 工具将所有没有任何透明度注释的程序集作为完全透明来处理。

/v

或

/verify

只验证程序集的批注是否正确；不会尝试进行多个传递以查找所需的所有注释，前提是程序集不会验证。

/x

或

/verbose

指定注释时的详细输出。

/y:目录

或

/symbolpath:目录

批注的过程中搜索符号文件时，请包括指定的目录。

备注

参数和程序集也可能在命令行上指定的响应文件中提供，且带有前缀 at 符号 (@)。 响应文件中的每行应包含单个参数或程序集的名称。

关于 .NET 安全 Annotator 详细信息，请参阅 .NET Security 博客项 Using SecAnnotate to Analyze Your Assemblies for Transparency Violations。

修订记录

Date

修订记录

原因

2011 年 4 月

添加了有关使用 Visual Studio 和 Windows SDK 命令提示符的信息。

信息补充。

2010 年 7 月

添加了指向安全 Annotator 的链接。

信息补充。