System.Runtime.CompilerServices.InternalsVisibleToAttribute 类

本文提供了此 API 参考文档的补充说明。

该 InternalsVisibleToAttribute 特性指定通常仅在当前程序集内可见的类型对指定的程序集可见。

通常，在 C# 或 Visual Basic 中具有作用域的类型和Friend成员internal仅在定义它们的程序集中可见。 作用域 protected internal （Protected Friend Visual Basic 中的作用域）的类型和成员仅在其自己的程序集中可见，或者对派生自其包含类的类型可见。 具有 private protected 作用域的类型和成员（Private Protected 在 Visual Basic 中的范围）在包含类或从当前程序集中的包含类派生的类型中可见

该 InternalsVisibleToAttribute 特性使这些类型和成员也对指定程序集中的类型可见，这称为友元程序集。 这仅适用于 internal （Friend 在 Visual Basic 中）、 protected internal（Protected Friend 在 Visual Basic 中）和 private protected （Private Protected 在 Visual Basic 中）成员，但不适用于 private 这些成员。

注意

对于 private protected （Private Protected 在 Visual Basic 中）成员，该 InternalsVisibleToAttribute 属性仅将辅助功能扩展到派生自 成员的包含类 的类型。

该属性在程序集级别应用。 这意味着它可以包含在源代码文件的开头，也可以包含在 Visual Studio 项目中的 AssemblyInfo 文件中。 可以使用该属性指定可以访问当前程序集的内部类型和成员的单个友元程序集。 可以通过两种方式定义多个友元程序集。 它们可以显示为单个程序集级属性，如以下示例所示。

[assembly:InternalsVisibleTo("Friend1a")]
[assembly:InternalsVisibleTo("Friend1b")]

<assembly:InternalsVisibleTo("Friend1a")>
<assembly:InternalsVisibleTo("Friend1b")>

它们还可以与单独的InternalsVisibleToAttribute标记一起显示，但单个assembly关键字 (keyword)，如以下示例所示。

[assembly:InternalsVisibleTo("Friend2a"), 
          InternalsVisibleTo("Friend2b")]

<Assembly:InternalsVisibleTo("Friend2a"), _
 Assembly:InternalsVisibleTo("Friend2b")>

友元程序集由 InternalsVisibleToAttribute 构造函数标识。 当前程序集和友元程序集都必须未签名，或者两个程序集都必须使用强名称进行签名。

如果两个程序集都是无符号的，则 assemblyName 参数由未指定目录路径或文件扩展名的友元程序集的名称组成。

如果两个程序集都使用强名称进行签名， InternalsVisibleToAttribute 则构造函数的参数必须包含程序集的名称，而不包含其目录路径或文件扩展名，以及完整的公钥（而不是其公钥令牌）。 若要获取强名称程序集的完整公钥，请参阅 本文后面的“获取完整公钥 ”部分。 有关与强名称程序集一起使用 InternalsVisibleToAttribute 的详细信息，请参阅 InternalsVisibleToAttribute 构造函数。

不要在参数中包含或VersionProcessorArchitecture字段的值CultureInfo;Visual Basic、C# 和 C++ 编译器将此视为编译器错误。 如果使用不将其视为错误（如 IL 汇编程序（ILAsm.exe）且程序集具有强名称的编译器， MethodAccessException 则首次指定友元程序集访问包含该属性的 InternalsVisibleToAttribute 程序集时将引发异常。

有关如何使用此属性的详细信息，请参阅 Friend 程序集 和 C++ 友元程序集。

获取完整的公钥

可以使用 强名称工具（Sn.exe） 从强名称键 （.snk） 文件中检索完整的公钥。 为此，请执行以下步骤：

1. 将公钥从强命名密钥文件提取到单独的文件中：

   Sn -p <snk_file> <outfile>

2. 向控制台显示完整的公钥：

   Sn -tp <outfile>

3. 将完整的公钥值复制并粘贴到源代码中。

使用 C 编译友元程序集#

如果使用 C# 编译器编译友元程序集，则必须使用 /out 编译器选项显式指定输出文件的名称（.exe或.dll）。 这是必需的，因为编译器尚未为它在绑定到外部引用时而正在构建的程序集生成名称。 对于 Visual Basic 编译器，/out 编译器选项是可选的，在使用 F# 编译器编译友元程序集时，不应使用相应的 -out 或 -o 编译器选项。

使用 C++ 编译友元程序集

在 C++ 中，若要使属性启用 InternalsVisibleToAttribute 的内部成员可供友元程序集访问，必须使用 as_friend C++ 指令中的属性。 有关详细信息，请参阅友元程序集 (C++)。