如何：创建签名的友元程序集（C# 和 Visual Basic）

项目
02/21/2013

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

在 Visual Studio 中创建签名的程序集和友元程序集

打开 Visual Studio 命令提示。
使用强名称工具，通过以下命令序列生成 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

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

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

' 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

// 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 并为其签名。

Vbc /target:library /keyfile:FriendAssemblies.snk friend_signed_A.vb

csc /target:library /keyfile:FriendAssemblies.snk friend_signed_A.cs

创建一个名为 friend_signed_B 的 Visual Basic 或 C# 文件，并包含以下代码。由于 friend_signed_A 将 friend_signed_B 指定为友元程序集，因此 friend_signed_B 中的代码可以访问 friend_signed_A 中的 Friend (Visual Basic) 或 internal (C#) 类型和成员。文件包含以下代码。

' 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

// 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 并为其签名。
```
Vbc /keyfile:FriendAssemblies.snk /r:friend_signed_A.dll friend_signed_B.vb
```
```
csc /keyfile:FriendAssemblies.snk /r:friend_signed_A.dll /out:friend_signed_B.exe friend_signed_B.cs
```
编译器生成的程序集的名称必须与传递给 InternalsVisibleToAttribute 特性的友元程序集的名称匹配。可以使用 /out 编译器选项显式设置该程序集。

在 C# 中，您必须使用 /out 编译器选项显式指定输出程序集（.exe 或 .dll）的名称。在 Visual Basic 中，这是可选的。有关更多信息，请参见 /out (Visual Basic) 和 /out（C# 编译器选项）。
运行 friend_signed_B.exe 文件。

程序将打印字符串“Class1.Test”。

安全性

InternalsVisibleToAttribute 特性和 StrongNameIdentityPermission 类之间存在相似性。主要的差异在于：StrongNameIdentityPermission 可以要求具有安全权限才能运行特定的一段代码，而 InternalsVisibleToAttribute 特性则控制 Friend (Visual Basic) 或 internal (C#) 类型和成员的可见性。

请参见

通过

如何：创建签名的友元程序集（C# 和 Visual Basic）

在 Visual Studio 中创建签名的程序集和友元程序集

安全性

请参见

任务

参考

概念

其他资源

其他资源