HOW TO：多載使用不定數目參數的程序 (Visual Basic)

發行項
02/28/2013

如果程序擁有 ParamArray (Visual Basic) 參數，就無法定義採用一維陣列當做參數陣列的多載版本。如需詳細資訊，請參閱多載化程序的考慮因素 (Visual Basic)中的＜ParamArray 參數的隱含多載＞一節。

若要多載可接受變動數目之參數的程序

確定程序和呼叫程式碼邏輯在多載版本中的好處，會比在 ParamArray 參數中的還多。請參閱多載化程序的考慮因素 (Visual Basic)中的＜多載和參數陣列＞一節。
決定程序在參數清單的變數部分中，應該接受的提供值數目。這可能包含沒有值的情況，也可能只有單一的一維陣列。
對於每一個提供值的可接受數目，撰寫 Sub 或 Function 宣告陳述式來定義對應的參數清單。不要在這個多載版本中使用 Optional 或 ParamArray 關鍵字。
在每個宣告中，於 Sub 或 Function 關鍵字的前面加上 Overloads (Visual Basic) 關鍵字。
遵循每一個宣告來撰寫程序程式碼，以便在呼叫程式碼提供與該宣告的參數清單相對應的值時，執行該程式碼。
請視需要以 End Sub 或 End Function 陳述式來結束每個程序。

範例

下列範例顯示 ParamArray (Visual Basic) 參數所定義的程序，然後顯示相等的多載程序集。

Sub p(ByVal d As Date, ByVal ParamArray c() As Char)

' The preceding definition is equivalent to the following overloads.
' Overloads Sub p(ByVal d As Date)
' Overloads Sub p(ByVal d As Date, ByVal c() As Char)
' Overloads Sub p(ByVal d As Date, ByVal c1 As Char)
' Overloads Sub p(ByVal d As Date, ByVal c1 As Char, ByVal c2 As Char)
' And so on, with an additional Char argument in each successive overload.

對於這類擁有採用一維陣列當做參數陣列的參數清單之程序，您無法多載。然而，您可以使用其他隱含多載的簽章。下面宣告可說明這點。

' The following overload is not valid because it takes an array for the parameter array.
' Overloads Sub p(ByVal x As Date, ByVal y() As Char)
' The following overload takes a single value for the parameter array and is valid.
Overloads Sub p(ByVal z As Date, ByVal w As Char)

多載版本的程式碼不必測試呼叫程式碼是否提供一或多個 ParamArray 參數值；若提供則顯示數目。Visual Basic 會將控制權傳遞給符合呼叫引數清單的版本。