共用方式為


如何:建立已簽署的 Friend 組件 (C# 和 Visual Basic)

在這個範例中,會示範如何將 Friend 組件與擁有強式名稱的組件搭配使用。 這兩個組件都必須有強式名稱。 雖然在這個範例中這兩個組件都使用相同金鑰,但它們也可以使用不同金鑰。

若要在 Visual Studio 中建立已簽署的組件和 Friend 組件

  1. 開啟 Visual Studio 命令提示字元。

  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 並包含下列程式碼的 Visual Basic 或 C# 檔案。 此程式碼會使用 InternalsVisibleToAttribute 屬性,將 friend_signed_B 宣告為 Friend 組件。

    強式名稱工具每次執行時都會產生新的公開金鑰。 因此,您必須將下列程式碼中的公開金鑰取代為剛產生的公開金鑰,如下列範例所示。

    ' 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();
        }
    }
    
  4. 使用下列命令編譯及簽署 friend_signed_A。

    Vbc /target:library /keyfile:FriendAssemblies.snk friend_signed_A.vb
    
    csc /target:library /keyfile:FriendAssemblies.snk friend_signed_A.cs
    
  5. 建立名為 friend_signed_B 並包含下列程式碼的 Visual Basic 或 C# 檔案。 因為 friend_signed_A 會將 friend_signed_B 指定為 Friend 組件,所以 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();
        }
    }
    
  6. 使用下列命令編譯及簽署 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 屬性的 Friend 組件名稱。 您可以使用 /out 編譯器選項明確設定此組件。

    在 C# 中,必須使用 /out 編譯器選項,明確指定輸出組件的名稱 (.exe 或 .dll)。 在 Visual Basic 中,這是選擇項。 如需詳細資訊,請參閱/out (Visual Basic)/out (C# 編譯器選項)

  7. 執行 friend_signed_B.exe 檔案。

    程式會列印字串 "Class1.Test"。

安全性

InternalsVisibleToAttribute 屬性和 StrongNameIdentityPermission 類別之間有相似處。 主要差異是 StrongNameIdentityPermission 可以要求安全性權限來執行特定程式碼區段,而 InternalsVisibleToAttribute 屬性則會控制 Friend (Visual Basic) 或 internal (C#) 型別和成員的可視性。

請參閱

工作

如何:建立未簽署的 Friend 組件 (C# 和 Visual Basic)

參考

InternalsVisibleToAttribute

/keyfile

Sn.exe (強式名稱工具)

概念

組件和全域組件快取 (C# 和 Visual Basic)

Friend 組件 (C# 和 Visual Basic)

C# 程式設計手冊

其他資源

建立和使用強式名稱的組件

Visual Basic 程式設計手冊