作法：建置多檔案組件

發行項
06/07/2024

注意

本文專屬於 .NET Framework。其不適用於較新的 .NET 實作，包括 .NET 6 和更新版本。

本文說明如何建立多檔案組件，並提供說明程序中每個步驟的程式碼。

注意

適用於 C# 和 Visual Basic 的 Visual Studio IDE 只能用來建立單一檔案組件。如果您想建立多檔案組件，則必須使用命令列編譯器或搭配 Visual C++ 使用 Visual Studio。只有 .NET Framework 支援多檔組件。

建立多檔案組件

將所有檔案編譯為程式碼模組，該檔案所包含的命名空間將由組件的其他模組參考。程式碼模組的預設副檔名為 .netmodule。

例如，假設 Stringer 檔案有名為 myStringer 的命名空間，其中包括名為 Stringer 的類別。 Stringer 類別含有 StringerMethod，可撰寫單行到主控台。

// Assembly building example in the .NET Framework.
using namespace System;

namespace myStringer
{
    public ref class Stringer
    {
    public:
        void StringerMethod()
        {
            System::Console::WriteLine("This is a line from StringerMethod.");
        }
    };
}

// 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.");
        }
    }
}

' Assembly building example in the .NET Framework.
Namespace myStringer
    Public Class Stringer
        Public Sub StringerMethod()
            System.Console.WriteLine("This is a line from StringerMethod.")
        End Sub
    End Class
End Namespace

請使用下列命令來編譯此程式碼：
```
cl /clr:pure /LN Stringer.cpp
```
```
csc /t:module Stringer.cs
```
```
vbc /t:module Stringer.vb
```
使用 /t: 編譯器選項指定 module 參數，表示應將檔案編譯成模組，而非編譯成組件。編譯器會產生稱為 Stringer.netmodule 的模組，可加入組件。

使用必要的編譯器選項來編譯其他所有模組，以便指出程式碼中所參考的其他模組。這個步驟使用 /addmodule 編譯器選項。

在下列範例，對於名為 Client 的程式碼模組，其進入點 Main 方法參考了步驟 1 所建立的 Stringer.netmodule 模組方法。

#using "Stringer.netmodule"

using namespace System;
using namespace myStringer; //The namespace created in Stringer.netmodule.

ref class MainClientApp
{
    // Static method Main is the entry point method.
public:
    static void Main()
    {
        Stringer^ myStringInstance = gcnew Stringer();
        Console::WriteLine("Client code executes");
        myStringInstance->StringerMethod();
    }
};

int main()
{
    MainClientApp::Main();
}

using System;
using myStringer;

class MainClientApp
{
    // Static method Main is the entry point method.
    public static void Main()
    {
        Stringer myStringInstance = new Stringer();
        Console.WriteLine("Client code executes");
        myStringInstance.StringerMethod();
    }
}

Imports myStringer

Class MainClientApp
    ' Static method Main is the entry point method.
    Public Shared Sub Main()
        Dim myStringInstance As New Stringer()
        Console.WriteLine("Client code executes")
        myStringInstance.StringerMethod()
    End Sub
End Class

請使用下列命令來編譯此程式碼：

cl /clr:pure /FUStringer.netmodule /LN Client.cpp

csc /addmodule:Stringer.netmodule /t:module Client.cs

vbc /addmodule:Stringer.netmodule /t:module Client.vb

請指定 /t:module 選項，因為這個模組將在下一個步驟中新增到組件。指定 /addmodule 選項，因為 Client 內的程式碼會參考 Stringer.netmodule 程式碼所建立的命名空間。編譯器會產生名為 Client.netmodule 的模組，其中包含另一個模組 Stringer.netmodule 的參考。

注意

C# 和 Visual Basic 編譯器支援使用下列兩個不同的語法來直接建立多檔案組件。

兩種編譯 (Compilation) 建立雙檔案組件：

cl /clr:pure /LN Stringer.cpp
cl /clr:pure Client.cpp /link /ASSEMBLYMODULE:Stringer.netmodule

csc /t:module Stringer.cs
csc Client.cs /addmodule:Stringer.netmodule

vbc /t:module Stringer.vb
vbc Client.vb /addmodule:Stringer.netmodule

單一編譯建立雙檔案組件：

cl /clr:pure /LN Stringer.cpp
cl /clr:pure Client.cpp /link /ASSEMBLYMODULE:Stringer.netmodule

csc /out:Client.exe Client.cs /out:Stringer.netmodule Stringer.cs

vbc /out:Client.exe Client.vb /out:Stringer.netmodule Stringer.vb

使用組件連結器 (Al.exe) 來建立輸出檔案，其中含有組件資訊清單。這個檔案含有所有模組的參考資訊或者是部分組件的資源。

在命令提示字元中，輸入下列命令：

al<模組名稱><模組名稱> … /main:<方法名稱>/out:<檔案名稱>/target:<組件檔案類型>

在這個命令中，「模組名稱」引數會指定組件中包含的所有模組名稱。 /main: 選項指定方法名稱，這個名稱是組件的進入點。 /out: 選項指定輸出檔案的名稱，其中包含組件中繼資料。 /target: 選項指定組件為主控台應用程式可執行檔 (.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
```
您可以使用 IL 反組譯工具 (Ildasm.exe) 來檢查組件的內容，或判斷檔案為組件或模組。

共用方式為

作法：建置多檔案組件

建立多檔案組件

另請參閱

其他資源