如何:创建已签名的友元程序集

本示例演示如何将友元程序集和具有强名称的程序集一起使用。 这两种程序集必须都使用强名称。 尽管本示例中的两种程序集使用相同的密钥,但可以对这两种程序集使用不同的密钥。

创建已签名的程序集和友元程序集

  1. 打开命令提示。

  2. 使用强名称工具,通过以下命令序列生成 keyfile 并显示其公钥。 有关详细信息,请参阅 Sn.exe(强名称工具)

    1. 生成此示例的强名称密钥,并将其存储在 FriendAssemblies.snk 文件中:

      sn -k FriendAssemblies.snk

    2. 从 FriendAssemblies.snk 文件中提取公钥,将其放入 FriendAssemblies.publickey 中 :

      sn -p FriendAssemblies.snk FriendAssemblies.publickey

    3. 显示存储在 FriendAssemblies.publickey 文件中的公钥:

      sn -tp FriendAssemblies.publickey

  3. 创建名为 friend_signed_A 的 C# 或 Visual Basic 文件,其中包含以下代码。 该代码使用 InternalsVisibleToAttribute 属性将 friend_signed_B 声明为友元程序集。

    强名称工具在每次运行时生成新的公钥。 因此,必须将以下代码中的公钥替换为刚生成的公钥,如以下示例所示。

    // friend_signed_A.cs  
    // Compile with:
    // csc /target:library /keyfile:FriendAssemblies.snk friend_signed_A.cs  
    using System.Runtime.CompilerServices;  
    
    [assembly: InternalsVisibleTo("friend_signed_B, PublicKey=0024000004800000940000000602000000240000525341310004000001000100e3aedce99b7e10823920206f8e46cd5558b4ec7345bd1a5b201ffe71660625dcb8f9a08687d881c8f65a0dcf042f81475d2e88f3e3e273c8311ee40f952db306c02fbfc5d8bc6ee1e924e6ec8fe8c01932e0648a0d3e5695134af3bb7fab370d3012d083fa6b83179dd3d031053f72fc1f7da8459140b0af5afc4d2804deccb6")]  
    class Class1  
    {  
        public void Test()  
        {  
            System.Console.WriteLine("Class1.Test");  
            System.Console.ReadLine();  
        }  
    }  
    
    ' friend_signed_A.vb  
    ' Compile with:
    ' Vbc -target:library -keyfile:FriendAssemblies.snk friend_signed_A.vb  
    Imports System.Runtime.CompilerServices  
    
    <Assembly: InternalsVisibleTo("friend_signed_B, PublicKey=0024000004800000940000000602000000240000525341310004000001000100e3aedce99b7e10823920206f8e46cd5558b4ec7345bd1a5b201ffe71660625dcb8f9a08687d881c8f65a0dcf042f81475d2e88f3e3e273c8311ee40f952db306c02fbfc5d8bc6ee1e924e6ec8fe8c01932e0648a0d3e5695134af3bb7fab370d3012d083fa6b83179dd3d031053f72fc1f7da8459140b0af5afc4d2804deccb6")>
    Public Class Class1  
        Public Sub Test()  
            System.Console.WriteLine("Class1.Test")  
            System.Console.ReadLine()  
        End Sub  
    End Class  
    
  4. 使用以下命令编译 friend_signed_A 并为其签名。

    csc /target:library /keyfile:FriendAssemblies.snk friend_signed_A.cs  
    
    Vbc -target:library -keyfile:FriendAssemblies.snk friend_signed_A.vb  
    
  5. 创建名为 friend_signed_B 的 C# 或 Visual Basic 文件,其中包含以下代码。 由于 friend_signed_A 将 friend_signed_B 指定为友元程序集,因此 friend_signed_B 中的代码可以访问 friend_signed_A 中的 internal (C#) 或 Friend (Visual Basic) 类型和成员。 文件包含以下代码。

    // friend_signed_B.cs  
    // Compile with:
    // csc /keyfile:FriendAssemblies.snk /r:friend_signed_A.dll /out:friend_signed_B.exe friend_signed_B.cs  
    public class Program  
    {  
        static void Main()  
        {  
            Class1 inst = new Class1();  
            inst.Test();  
        }  
    }  
    
    ' friend_signed_B.vb  
    ' Compile with:
    ' Vbc -keyfile:FriendAssemblies.snk -r:friend_signed_A.dll friend_signed_B.vb  
    Module Sample  
        Public Sub Main()  
            Dim inst As New Class1  
            inst.Test()  
        End Sub  
    End Module  
    
  6. 使用以下命令编译 friend_signed_B 并为其签名。

    csc /keyfile:FriendAssemblies.snk /r:friend_signed_A.dll /out:friend_signed_B.exe friend_signed_B.cs  
    
    vbc -keyfile:FriendAssemblies.snk -r:friend_signed_A.dll friend_signed_B.vb  
    

    编译器生成的程序集的名称必须与传递给 InternalsVisibleToAttribute 属性的友元程序集的名称匹配。 必须使用 -out 编译器选项显式指定输出程序集(.exe 或 .dll)的名称。 有关详细信息,请参阅OutputAssembly(C# 编译器选项)-out (Visual Basic)

  7. 运行 friend_signed_B.exe 文件。

    程序将输出字符串“Class1.Test”。

.NET 安全性

InternalsVisibleToAttribute 属性和 StrongNameIdentityPermission 类之间具有相似之处。 主要区别是,StrongNameIdentityPermission 可以要求安全权限来运行一段特定代码,而 InternalsVisibleToAttribute 属性控制 internal (C#) 和 Friend (Visual Basic) 类型和成员的可见性。

请参阅