大网数据广告活动
.NET 与 C# 开发

友元程序集 (C#)

· 52CE 我爱测

友元程序集是可以访问其他程序集的内部(C# 中的或在 Visual Basic 中的友元)类型和成员的程序集 。 如果将一个程序集标识为友元程序集,则无需再将类型和成员标记为公共,其他程序集就能访问它们。 此举在下列情境中尤其方便:

友元程序集是可以访问其他程序集的内部(C# 中的或在 Visual Basic 中的友元)类型和成员的程序集 。 如果将一个程序集标识为友元程序集,则无需再将类型和成员标记为公共,其他程序集就能访问它们。 此举在下列情境中尤其方便:

  • 在单元测试期间,当测试代码在单独的程序集上运行,但要求访问标记为 C# 中的 internal 或 Visual Basic 中的 Friend 的正在被测试的程序集中的成员时。

  • 当你正在开发类库,库的添加包含在单独的程序集中,但要求访问标记为 C# 中的 internal 或 Visual Basic 中的 Friend 的现有程序集中的成员时。

备注

可使用 xref:System.Runtime.CompilerServices.InternalsVisibleToAttribute 属性标识给定程序集的一个或多个友元程序集。 如下示例使用程序集 A 中的 xref:System.Runtime.CompilerServices.InternalsVisibleToAttribute 属性,并将程序集 AssemblyB 指定为友元程序集。 这使程序集 AssemblyB 能访问标记为 C# 中的 internal 或 Visual Basic 中的 Friend 的程序集 A 中的所有类型和成员。

Note: 在编译将访问另一程序集(程序集 A)的内部类型或内部成员的程序集(程序集 AssemblyB)时,必须使用 /out 编译器选项显式指定输出文件(.exe 或 .dll)的名称。 这是必需的,因为编译器尚未为它在绑定到外部引用时而正在构建的程序集生成名称。 有关详细信息,请参阅 /out (C#) 或 /out (Visual Basic)。

C#

using System.Runtime.CompilerServices;
using System;

[assembly: InternalsVisibleTo("AssemblyB")]

// The class is internal by default.
class FriendClass
{
    public void Test()
    {
        Console.WriteLine("Sample Class");
    }
}

// Public class that has an internal method.
public class ClassWithFriendMethod
{
    internal void Test()
    {
        Console.WriteLine("Sample Method");
    }

}

Visual Basic

Imports System.Runtime.CompilerServices
Imports System
<Assembly: InternalsVisibleTo("AssemblyB")>

' Friend class.
Friend Class FriendClass
    Public Sub Test()
        Console.WriteLine("Sample Class")
    End Sub
End Class

' Public class with a Friend method.
Public Class ClassWithFriendMethod
    Friend Sub Test()
        Console.WriteLine("Sample Method")
    End Sub
End Class

只有显式指定为友元的程序集才能访问 internal(C# 中的或在 Visual Basic 中的 Friend)类型和成员。 例如,如果程序集 B 是程序集 A 的友元,且程序集 C 引用了程序集 B,则 C 无法访问 A 中的 internal(C# 中的或在 Visual Basic 中的 Friend)类型。

编译器对传递到 xref:System.Runtime.CompilerServices.InternalsVisibleToAttribute 属性的友元程序集名称执行一些基本验证。 如果程序集 A 将 B 声明为友元程序集,则验证规则如下:

xref:System.Security.Permissions.StrongNameIdentityPermission 类还提供类型共享功能,但具有以下差异:

有关如何从模块文件(扩展名为 .netmodule 的文件)访问程序集的 internal(在 C# 中)或 Friend(在 Visual Basic 中)类型和方法,请参阅 /moduleassemblyname (C#) 或 /moduleassemblyname (Visual Basic)。

请参阅

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 03/03/2019
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。