Share via


HOW TO:使用命令列建立和使用組件 (C# 和 Visual Basic)

組件又稱為動態連結程式庫 (DLL),會在執行階段連結到您的程式。 若要示範 DLL 的建立和使用方式,請參考下面案例:

  • MathLibrary.DLL:程式庫檔案,包含可在執行階段呼叫的方法。 在此範例中,DLL 包含 Add 和 Multiply 這兩個方法。

  • Add:包含 Add 方法的原始程式檔。 它會傳回其參數的總和。 包含 Add 方法的 AddClass 類別是 UtilityMethods 命名空間的成員。

  • Mult:原始程式碼,其包含了 Multiply 方法。 它會傳回其參數的乘積。 包含 Multiply 方法的 MultiplyClass 類別是 UtilityMethods 命名空間的成員。

  • TestCode:包含 Main 方法的檔案。 它使用 DLL 中的方法來計算執行階段引數的總和與乘積。

範例

' File: Add.vb 
Namespace UtilityMethods
    Public Class AddClass
        Public Shared Function Add(ByVal i As Long, ByVal j As Long) As Long
            Return i + j
        End Function
    End Class
End Namespace


...


' File: Mult.vb
Namespace UtilityMethods
    Public Class MultiplyClass
        Public Shared Function Multiply(ByVal x As Long, ByVal y As Long) As Long
            Return x * y
        End Function
    End Class
End Namespace


...


' File: TestCode.vb

Imports UtilityMethods

Module Test

    Sub Main(ByVal args As String())


        System.Console.WriteLine("Calling methods from MathLibrary.DLL:")

        If args.Length <> 2 Then
            System.Console.WriteLine("Usage: TestCode <num1> <num2>")
            Return
        End If

        Dim num1 As Long = Long.Parse(args(0))
        Dim num2 As Long = Long.Parse(args(1))

        Dim sum As Long = AddClass.Add(num1, num2)
        Dim product As Long = MultiplyClass.Multiply(num1, num2)

        System.Console.WriteLine("{0} + {1} = {2}", num1, num2, sum)
        System.Console.WriteLine("{0} * {1} = {2}", num1, num2, product)

    End Sub

End Module

' Output (assuming 1234 and 5678 are entered as command-line arguments):
' Calling methods from MathLibrary.DLL:
' 1234 + 5678 = 6912
' 1234 * 5678 = 7006652        

// File: Add.cs 
namespace UtilityMethods
{
    public class AddClass 
    {
        public static long Add(long i, long j) 
        { 
            return (i + j);
        }
    }
}


...


// File: Mult.cs
namespace UtilityMethods 
{
    public class MultiplyClass
    {
        public static long Multiply(long x, long y) 
        {
            return (x * y); 
        }
    }
}


...


// File: TestCode.cs

using UtilityMethods;

class TestCode
{
    static void Main(string[] args) 
    {
        System.Console.WriteLine("Calling methods from MathLibrary.DLL:");

        if (args.Length != 2)
        {
            System.Console.WriteLine("Usage: TestCode <num1> <num2>");
            return;
        }

        long num1 = long.Parse(args[0]);
        long num2 = long.Parse(args[1]);

        long sum = AddClass.Add(num1, num2);
        long product = MultiplyClass.Multiply(num1, num2);

        System.Console.WriteLine("{0} + {1} = {2}", num1, num2, sum);
        System.Console.WriteLine("{0} * {1} = {2}", num1, num2, product);
    }
}
/* Output (assuming 1234 and 5678 are entered as command-line arguments):
    Calling methods from MathLibrary.DLL:
    1234 + 5678 = 6912
    1234 * 5678 = 7006652        
*/

這個檔案包含了使用 Add 和 Multiply 等 DLL 方法的演算法。 首先,它會剖析從命令列輸入的引數 num1 和 num2, 然後再使用 AddClass 類別中的 Add 方法計算總和,並使用 MultiplyClass 類別上的 Multiply 方法計算乘積。

請注意,檔案開頭的 using 指示詞 (在 Visual Basic 中則是 Imports) 可以讓您使用未限定的類別名稱,在編譯時期參考 DLL 方法,如下所示:

MultiplyClass.Multiply(num1, num2)
MultiplyClass.Multiply(num1, num2);

否則,您必須使用完整名稱,如下所示:

UtilityMethods.MultiplyClass.Multiply(num1, num2)
UtilityMethods.MultiplyClass.Multiply(num1, num2);

執行

若要執行此程式,請輸入 EXE 檔的名稱,接著輸入兩個數目,如下所示:

TestCode 1234 5678

編譯程式碼

若要建立 MathLibrary.DLL 檔案,請使用下列命令列編譯 Add 和 Mult 兩個檔案。

vbc /target:library /out:MathLibrary.DLL Add.vb Mult.vb
csc /target:library /out:MathLibrary.DLL Add.cs Mult.cs

此處的 /target:library 編譯器選項會通知編譯器輸出一個 DLL,而不要輸出一個 EXE 檔案。 後面接續著一個檔案名稱的 /out 編譯器選項則是用來指定該 DLL 的檔案名稱。 否則編譯器會使用第一個檔案 (Add.cs) 當成 DLL 的名稱。

若要建立可執行檔 TestCode.exe,請使用下列命令列:

vbc /out:TestCode.exe /reference:MathLibrary.DLL TestCode.vb
csc /out:TestCode.exe /reference:MathLibrary.DLL TestCode.cs

此處的 /out 編譯器選項會通知編譯器輸出一個 EXE 檔案,並指定輸出檔案的名稱 (TestCode.exe)。 這個編譯器選項是選擇性的。 此處的 /reference 編譯器選項會指定此程式所使用的 DLL 檔案。 如需詳細資訊,請參閱 /reference (適用於 C#) 和 /reference (Visual Basic) (適用於 Visual Basic)。

如需從命令列建置的詳細資訊,請參閱使用 csc.exe 建置命令列從命令列建置 (Visual Basic)

請參閱

概念

C# 程式設計手冊

組件和全域組件快取 (C# 和 Visual Basic)

建立類別以包裝 DLL 函式

偵錯 DLL 專案

其他資源

Visual Basic 程式設計手冊