Практическое руководство. Создание подписанных дружественных сборок

В этом примере демонстрируется использование дружественных сборок со сборками, имеющими строгие имена. Обе сборки должны иметь строгое имя. Хотя обе сборки в этом примере используют одинаковые ключи, вы можете использовать для двух сборок разные ключи.

Создание подписанной и дружественной сборки

  1. Откройте окно командной строки.

  2. Используйте следующую последовательность команд в средстве задания строгих имен для формирования файла ключа и отображения его открытого ключа. Дополнительные сведения см. в разделе 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. Создайте файл C# или Visual Basic с именем friend_signed_A, содержащий приведенный ниже код. Атрибут 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. Создайте файл C# или Visual Basic с именем friend_signed_B, содержащий приведенный ниже код. Так как сборка friend_signed_A указывает сборку friend_signed_B в качестве дружественной, код в сборке friend_signed_B может обращаться к типам и членам internal (C#) или Friend (Visual Basic) в сборке friend_signed_A. Файл содержит следующий код.

    // 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. Необходимо явно указать имя выходной сборки (EXE или DLL) с помощью параметра компилятора -out. Дополнительные сведения см. в разделе -out (параметры компилятора C#) или -out (Visual Basic).

  7. Запустите файл friend_signed_B.exe.

    Программа выводит строку Class1.Test.

Безопасность в .NET

Между атрибутом InternalsVisibleToAttribute и классом StrongNameIdentityPermission существует определенное сходство. Основное отличие заключается в том, что для выполнения StrongNameIdentityPermission в определенном разделе кода могут потребоваться разрешения системы безопасности, тогда как атрибут InternalsVisibleToAttribute определяет видимость членов и типов internal (C#) или Friend (Visual Basic).

См. также