HOW TO:建立已簽署的 Friend 組件 (C# 和 Visual Basic)
在這個範例中,會示範如何將 Friend 組件與擁有強式名稱的組件搭配使用。這兩個組件都必須有強式名稱。雖然在這個範例中這兩個組件都使用相同金鑰,但它們也可以使用不同金鑰。
若要在 Visual Studio 中建立已簽署的組件和 Friend 組件
開啟 Visual Studio 命令提示字元。
搭配強式名稱工具使用下列命令序列,產生 keyfile (金鑰檔) 並顯示其公開金鑰。如需詳細資訊,請參閱Sn.exe (強式名稱工具)。
在這個範例中,產生強式名稱金鑰並將它儲存在 FriendAssemblies.snk 檔中:
sn -k FriendAssemblies.snk
從 FriendAssemblies.snk 擷取公開金鑰並將它放入 FriendAssemblies.publickey:
sn -p FriendAssemblies.snk FriendAssemblies.publickey
顯示儲存在 FriendAssemblies.publickey 檔中的公開金鑰:
sn -tp FriendAssemblies.publickey
建立名為 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(); } }
使用下列命令編譯及簽署 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 組件,所以 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 屬性的 Friend 組件名稱。您可以使用 /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#) 型別和成員的可視性。
請參閱
工作
HOW TO:建立未簽署的 Friend 組件 (C# 和 Visual Basic)