HOW TO：建置多檔案組件
更新：2007 年 11 月
這個章節說明建立多檔案組件時所用的程序，並提供完整的範例，說明程序中的每一個步驟。
若要建立多檔案組件
將所有檔案編譯為程式碼模組，該檔案所包含的命名空間將由組件的其他模組參考。程式碼模組的預設副檔名為 .netmodule。例如，如果稱為 Stringer 的檔案建立稱為 myStringer 的命名空間 (在 Client 檔案程式碼中參考)，應先將 Stringer 編譯成程式碼模組。
使用必要的編譯器選項來編譯其他所有模組，以便指出程式碼中所參考的其他模組。
使用組件連結器 (Al.exe) 來建立輸出檔案，其中含有組件資訊清單。這個檔案含有所有模組的參考資訊或者是部分組件的資源。
.gif "注意事項")
注意事項：Visual Studio 2005 IDE for C# 和 Visual Basic 只能用來建立單一檔案組件。如果您想建立多檔案組件，必須使用命令列編譯器或搭配 Visual C++ 使用 Visual Studio 2005。
下列程式碼範例說明上述程序的步驟 1，即為使用由其他檔案參考的命名空間編譯檔案。該範例使用某些簡易的程式碼做為 Stringer 的開頭，因為 Stringer 擁有 myStringer 命名空間，其中含有 Stringer 類別。Stringer 類別含有 StringerMethod，可撰寫單行到主控台。
' Assembly building example in the .NET Framework.
Imports System
Namespace myStringer
Public Class Stringer
Public Sub StringerMethod()
Console.WriteLine("This is a line from StringerMethod.")
End Sub
End Class
End Namespace
// Assembly building example in the .NET Framework.
using System;
namespace myStringer
{
public class Stringer
{
public void StringerMethod()
{
System.Console.WriteLine("This is a line from StringerMethod.");
}
}
}
請使用下列命令來編譯此程式碼：
vbc /t:module Stringer.vb
csc /t:module Stringer.cs
指定 module 參數時使用 /t: 編譯器選項，表示應將檔案編譯成模組，而非編譯成組件。編譯器可產生 Stringer.netmodule 模組，您可以將它新增到組件。
在上述程序的步驟 2，您必須編譯參考其他模組的模組。這個步驟使用 /addmodule 編譯器選項。在下列範例中，Client 程式碼模組擁有進入點 Main 方法，該方法會參考步驟 1 建立的 Stringer.dll 模組方法。
下列範例說明 Client 程式碼。
Imports System
Imports myStringer 'The namespace created in Stringer.netmodule.
Class MainClientApp
' Shared method Main is the entry point method.
Public Shared Sub Main()
Dim myStringInstance As New Stringer()
Console.WriteLine("Client code executes")
'myStringComp.Stringer()
myStringInstance.StringerMethod()
End Sub
End Class
using System;
using myStringer; //The namespace created in Stringer.netmodule.
class MainClientApp
{
// Static method Main is the entry point method.
public static void Main()
{
Stringer myStringInstance = new Stringer();
Console.WriteLine("Client code executes");
//myStringComp.Stringer();
myStringInstance.StringerMethod();
}
}
請使用下列命令來編譯此程式碼：
vbc /addmodule:Stringer.netmodule /t:module Client.vb
csc /addmodule:Stringer.netmodule /t:module Client.cs
請指定 /t:module 選項，因為這個模組將在下一個步驟中新增到組件。請指定 /addmodule 選項，因為 Client 的程式碼參考 Stringer.netmodule 程式碼所建立的命名空間。編譯器會產生 Client.netmodule 模組，其中含有對另一個模組 Stringer.netmodule 的參考。
| 注意事項： |
|---|
C# 和 Visual Basic 編譯器支援使用下列兩個不同的語法來直接建立多檔案組件。 |
兩種編譯 (Compilation) 建立雙檔案組件：
vbc /t:module Stringer.vb vbc Client.vb /addmodule:Stringer.netmodulecsc /t:module Stringer.cs csc Client.cs /addmodule:Stringer.netmodule單一編譯建立雙檔案組件：
vbc /out:Stringer.netmodule Stringer.vb /out:Client.exe Client.vbcsc /out:Client.exe Client.cs /out:Stringer.netmodule Stringer.cs
您可以使用組件連結器 (Al.exe) 從編譯程式碼模組集合建立組件。
若要使用組件連結器建立多檔案組件
在命令提示字元中輸入下列命令：
al <module name> <module name> … /main:<method name> /out:<file name> /target:<assembly file type>
在這個命令中，module name 引數指定組件中包含所有模組名稱。/main: 選項指定方法名稱，這個名稱是組件的進入點。/out: 選項指定輸出檔案的名稱，其中包含組件中繼資料 (Metadata)。/target: 選項指定組件為主控台應用程式 (Console Application) 可執行檔 (.exe)、Windows 可執行檔 (.win) 或程式庫 (.lib) 檔案。
下列範例中，Al.exe 建立組件，該組件為 myAssembly.exe 主控台應用程式可執行檔。該應用程式是由兩個稱為 Client.netmodule 和 Stringer.netmodule 的模組，以及僅包含組件中繼資料且稱為 myAssembly.exe, 的可執行檔所組成。組件的進入點為 MainClientApp 類別的 Main 方法，位於 Client.dll 中。
al Client.netmodule Stringer.netmodule /main:MainClientApp.Main /out:myAssembly.exe /target:exe
您可以使用 MSIL 反組譯工具 (Ildasm.exe) 來檢查組件的內容，或判斷檔案是否為組件或模組。