共用方式為


作法:建置多檔案組件

注意

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

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

注意

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

建立多檔案組件

  1. 將所有檔案編譯為程式碼模組,該檔案所包含的命名空間將由組件的其他模組參考。 程式碼模組的預設副檔名為 .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
    
  2. 請使用下列命令來編譯此程式碼:

    cl /clr:pure /LN Stringer.cpp
    
    csc /t:module Stringer.cs
    
    vbc /t:module Stringer.vb
    

    使用 /t: 編譯器選項指定 module 參數,表示應將檔案編譯成模組,而非編譯成組件。 編譯器會產生稱為 Stringer.netmodule 的模組,可加入組件。

  3. 使用必要的編譯器選項來編譯其他所有模組,以便指出程式碼中所參考的其他模組。 這個步驟使用 /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
    
  4. 請使用下列命令來編譯此程式碼:

    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
    
  5. 使用組件連結器 (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) 來檢查組件的內容,或判斷檔案為組件或模組。

另請參閱