如何：建立已簽署的朋友元件

  • 發行項

此範例示範如何搭配具有強式名稱的組件使用 friend 組件。 這兩個組件都必須具有強式名稱。 雖然此範例中的兩個組件使用相同的金鑰，但您可以針對這兩個組件使用不同的金鑰。

建立已簽署的元件和friend元件

  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. 建立名為 friend_signed_A 的 C# 或 Visual Basic 檔案，其中包含下列程式代碼。 程序代碼會InternalsVisibleToAttribute使用 屬性將friend_signed_B宣告為friend元件。

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

    // 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元件，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 屬性的 Friend 組件名稱。 您必須使用編譯程式選項，明確指定輸出元件的名稱（.exe或.dll）。-out 如需詳細資訊，請參閱 OutputAssembly （C# 編譯程式選項） 或 -out （Visual Basic） 。

  7. 執行friend_signed_B.exe檔案。

    程序會輸出字串 Class1.Test。

.NET 安全性

InternalsVisibleToAttribute 屬性和 StrongNameIdentityPermission 類別之間有相似性。 主要差異在於，StrongNameIdentityPermission可以要求安全性許可權來執行特定區段的程序代碼，而 InternalsVisibleToAttribute 屬性可控制 （C#） 或 Friend （Visual Basic） 類型和成員的internal可見度。

另請參閱