Compartilhar via


Como: criar assemblies amigáveis não assinados

Este exemplo mostra como usar assemblies amigáveis com assemblies não assinados.

Criar um assembly e um assembly amigável

  1. Abra um prompt de comando.

  2. Crie um arquivo C# ou Visual Basic chamado friend_unsigned_A que contenha o código a seguir. O código usa o atributo InternalsVisibleToAttribute para declarar friend_unsigned_B como assembly amigável.

    // friend_unsigned_A.cs
    // Compile with:
    // csc /target:library friend_unsigned_A.cs
    using System.Runtime.CompilerServices;
    using System;
    
    [assembly: InternalsVisibleTo("friend_unsigned_B")]
    
    // Type is internal by default.
    class Class1
    {
        public void Test()
        {
            Console.WriteLine("Class1.Test");
        }
    }
    
    // Public type with internal member.
    public class Class2
    {
        internal void Test()
        {
            Console.WriteLine("Class2.Test");
        }
    }
    
    ' friend_unsigned_A.vb
    ' Compile with:
    ' vbc -target:library friend_unsigned_A.vb
    Imports System.Runtime.CompilerServices
    
    <Assembly: InternalsVisibleTo("friend_unsigned_B")>
    
    ' Friend type.
    Friend Class Class1
        Public Sub Test()
            Console.WriteLine("Class1.Test")
        End Sub
    End Class
    
    ' Public type with Friend member.
    Public Class Class2
        Friend Sub Test()
            Console.WriteLine("Class2.Test")
        End Sub
    End Class
    
  3. Compile e assine ffriend_unsigned_A usando o seguinte comando:

    csc /target:library friend_unsigned_A.cs
    
    vbc -target:library friend_unsigned_A.vb
    
  4. Crie um arquivo C# ou Visual Basic chamado friend_unsigned_B que contenha o código a seguir. Como friend_unsigned_A especifica friend_unsigned_B como assembly amigável, o código em friend_unsigned_B pode acessar tipos internal (C#) ou Friend (Visual Basic) e membros de friend_unsigned_A.

    // friend_unsigned_B.cs
    // Compile with:
    // csc /r:friend_unsigned_A.dll /out:friend_unsigned_B.exe friend_unsigned_B.cs
    public class Program
    {
        static void Main()
        {
            // Access an internal type.
            Class1 inst1 = new Class1();
            inst1.Test();
    
            Class2 inst2 = new Class2();
            // Access an internal member of a public type.
            inst2.Test();
    
            System.Console.ReadLine();
        }
    }
    
    ' friend_unsigned_B.vb
    ' Compile with:
    ' vbc -r:friend_unsigned_A.dll friend_unsigned_B.vb
    Module Module1
        Sub Main()
            ' Access a Friend type.
            Dim inst1 As New Class1()
            inst1.Test()
    
            Dim inst2 As New Class2()
            ' Access a Friend member of a public type.
            inst2.Test()
    
            System.Console.ReadLine()
        End Sub
    End Module
    
  5. Compile friend_unsigned_B usando o comando a seguir.

    csc /r:friend_unsigned_A.dll /out:friend_unsigned_B.exe friend_unsigned_B.cs
    
    vbc -r:friend_unsigned_A.dll friend_unsigned_B.vb
    

    O nome do assembly gerado pelo compilador deve corresponder ao nome do assembly amigável passado para o atributo InternalsVisibleToAttribute. Você deve especificar explicitamente o nome do assembly de saída (.exe ou .dll) usando a opção do compilador -out. Para obter mais informações, consulte OutputAssembly (opções do compilador C#) ou -out (Visual Basic).

  6. Execute o arquivo friend_unsigned_B.exe.

    O programa imprime duas cadeias de caracteres: Class1.Test e Class2.Test.

Segurança do .NET

Há semelhanças entre o atributo InternalsVisibleToAttribute e a classe StrongNameIdentityPermission. A principal diferença é que StrongNameIdentityPermission pode solicitar permissões de segurança para executar determinada seção de código, enquanto o atributo InternalsVisibleToAttribute controla a visibilidade de membros e tipos de internal ou Friend (Visual Basic).

Confira também