友元程序集 (C++)

项目
04/03/2023

对于适用运行时，友元程序集语言功能使位于程序集组件命令空间范围或全局范围的类型可供一个或多个客户端程序集或 .netmodule 访问。

所有运行时

备注

（并不是所有运行时都支持此语言功能。）

Windows 运行时

备注

（Windows 运行时不支持此语言功能。）

要求

编译器选项： /ZW

公共语言运行时

备注

使位于程序集组件命名空间范围或全局范围的类型可供客户端程序集或 .netmodule 访问

在组件中，指定程序集特性 InternalsVisibleToAttribute，然后传递将访问位于组件命名空间范围或全局范围的类型的客户端程序集或 .netmodule 的名称。您可通过指定其他特性来指定多个客户端程序集或 .netmodule。
在客户端程序集或 .netmodule 中，当您使用 #using 引用组件程序集时，请传递 as_friend 特性。如果您为未指定 as_friend 的程序集指定 InternalsVisibleToAttribute 特性，则将在您尝试访问位于组件命令空间范围或全局范围的类型时引发运行时异常。

如果包含 InternalsVisibleToAttribute 特性的程序集没有强名称，但使用 as_friend 特性的客户端程序集有，则将导致生成错误。

虽然位于命名空间范围和全局范围的类型可为客户端程序集所知，但成员可访问性仍然有效。例如，您无法访问私有成员。

必须显式授予对程序集中所有类型的访问权限。例如，如果程序集 C 引用程序集 B，而程序集 B 具有对程序集 A 中所有类型的访问权限，则程序集 C 没有对程序集 A 中所有类型的访问权限。

有关如何签名，即如何为使用 Microsoft C++ 编译器生成的程序集提供强名称的信息，请参阅强名称程序集（程序集签名）（C++/CLI）。

作为对使用友元程序集功能的替代，您可使用 StrongNameIdentityPermission 限制对单独类型的访问。

要求

编译器选项： /clr

示例

以下代码示例定义了指定对组件中类型具有访问权限的客户端程序集的组件。

// friend_assemblies.cpp
// compile by using: /clr /LD
using namespace System::Runtime::CompilerServices;
using namespace System;
// an assembly attribute, not bound to a type
[assembly:InternalsVisibleTo("friend_assemblies_2")];

ref class Class1 {
public:
   void Test_Public() {
      Console::WriteLine("Class1::Test_Public");
   }
};

下一代码示例访问组件中的私有类型。

// friend_assemblies_2.cpp
// compile by using: /clr
#using "friend_assemblies.dll" as_friend

int main() {
   Class1 ^ a = gcnew Class1;
   a->Test_Public();
}

Class1::Test_Public

下一代码示例定义了未指定将对组件中类型具有访问权限的客户端程序集的组件。

请注意，组件是使用 /opt:noref 链接的。这确保私有类型在组件的元数据中发出，InternalsVisibleTo 特性存在时不需要元数据。有关详细信息，请参阅 /OPT（优化）。

// friend_assemblies_3.cpp
// compile by using: /clr /LD /link /opt:noref
using namespace System;

ref class Class1 {
public:
   void Test_Public() {
      Console::WriteLine("Class1::Test_Public");
   }
};

以下代码示例定义了尝试访问组件（其未为其私有类型提供访问权限）中私有类型的客户端。由于运行时的行为，如果您需要捕获异常，则必须尝试访问帮助器函数中的私有类型。

// friend_assemblies_4.cpp
// compile by using: /clr
#using "friend_assemblies_3.dll" as_friend
using namespace System;

void Test() {
   Class1 ^ a = gcnew Class1;
}

int main() {
   // to catch this kind of exception, use a helper function
   try {
      Test();
   }
   catch(MethodAccessException ^ e) {
      Console::WriteLine("caught an exception");
   }
}

caught an exception

下一代码示例演示了如何创建强名称组件，其指定将对组件中类型具有访问权限的客户端程序集。

// friend_assemblies_5.cpp
// compile by using: /clr /LD /link /keyfile:friend_assemblies.snk
using namespace System::Runtime::CompilerServices;
using namespace System;
// an assembly attribute, not bound to a type

[assembly:InternalsVisibleTo("friend_assemblies_6, PublicKey=00240000048000009400000006020000002400005253413100040000010001000bf45d77fd991f3bff0ef51af48a12d35699e04616f27ba561195a69ebd3449c345389dc9603d65be8cd1987bc7ea48bdda35ac7d57d3d82c666b7fc1a5b79836d139ef0ac8c4e715434211660f481612771a9f7059b9b742c3d8af00e01716ed4b872e6f1be0e94863eb5745224f0deaba5b137624d7049b6f2d87fba639fc5")];

private ref class Class1 {
public:
   void Test_Public() {
      Console::WriteLine("Class1::Test_Public");
   }
};

请注意，组件必须指定其公钥。我们建议您在命令提示符处按顺序运行下列命令以创建密钥对并获取公钥：

sn -d friend_assemblies.snk

sn -k friend_assemblies.snk

sn -i friend_assemblies.snk friend_assemblies.snk

sn -pc friend_assemblies.snk key.publickey

sn -tp key.publickey

下一代码示例访问强名称组件中的私有类型。

// friend_assemblies_6.cpp
// compile by using: /clr /link /keyfile:friend_assemblies.snk
#using "friend_assemblies_5.dll" as_friend

int main() {
   Class1 ^ a = gcnew Class1;
   a->Test_Public();
}

Class1::Test_Public

另请参阅

适用于运行时平台的组件扩展