HOW TO：多載使用選擇性參數的程序 (Visual Basic)

發行項
02/28/2013

如果程序有一或多個 Optional (Visual Basic) 參數，則無法定義符合任一其隱含多載的多載版本。如需詳細資訊，請參閱多載化程序的考慮因素 (Visual Basic)中的＜選擇性參數的隱含多載＞一節。

一個選擇性參數

若要多載採用一個選擇性參數的程序

撰寫將選擇性參數包含在參數清單中的 Sub 或 Function 宣告陳述式 (Declaration Statement)。不要在這個多載版本中使用 Optional 關鍵字。
在 Sub 或 Function 關鍵字的前面加上 Overloads (Visual Basic) 關鍵字。
撰寫呼叫程式碼在提供選擇性引數時所應執行的程序碼。
請視需要以 End Sub 或 End Function 陳述式來結束程序。
撰寫與第一個宣告相同的第二個宣告陳述式，但它不會將選擇性參數包含在參數清單中。

撰寫呼叫程式碼未提供選擇性引數時所應執行的程序碼。請視需要以 End Sub 或 End Function 陳述式來結束程序。

下列範例會顯示一個有定義選擇性參數的程序、兩個對等的多載程序，而最後是無效和有效多載版本的範例。

Sub q(ByVal b As Byte, Optional ByVal j As Long = 6)

' The preceding definition is equivalent to the following two overloads.
' Overloads Sub q(ByVal b As Byte)
' Overloads Sub q(ByVal b As Byte, ByVal j As Long)

' Therefore, the following overload is not valid because the signature is already in use.
' Overloads Sub q(ByVal c As Byte, ByVal k As Long)
' The following overload uses a different signature and is valid.
Overloads Sub q(ByVal b As Byte, ByVal j As Long, ByVal s As Single)

多個選擇性參數

若是有多個選擇性參數的程序，則一般需要兩個以上的多載版本。例如，如果有兩個選擇性參數，且呼叫程式碼可單獨提供或略過每個參數，則需要四個多載版本，而所提供引數的每個可能組合都會有一個版本。

當選擇性參數的數目增加時，多載化 (Overloading) 的複雜性也會增加。除非不接受某些引數的組合，否則 N 選擇性參數需要 2 ^ N 個多載版本。根據程序本質的不同，您可能會發現定義所有多載版本的額外努力會帶來清楚的邏輯。

若要多載採用一個以上之選擇性參數的程序

確定程序邏輯會接受所提供選擇性引數的哪些組合，如果選擇性參數與另一個選擇性參數具有相依性關係，則可能會引發無法接受的組合。例如，如果某個參數會接受 (Accept) 配偶的姓名，而另一個參數會接受配偶的年齡，則程序邏輯將無法接受提供了年齡卻略過姓名的引數組合。
針對所提供選擇性引數的每個可接受組合，撰寫 Sub 或 Function 宣告陳述式，用以定義對應的參數清單。不要使用 Optional 關鍵字。
在每個宣告中，於 Sub 或 Function 關鍵字的前面加上 Overloads (Visual Basic) 關鍵字。
在每個宣告後面，撰寫呼叫程式碼在提供與該宣告之參數清單對應的引數清單時，所應執行的程序碼。
請視需要以 End Sub 或 End Function 陳述式來結束每個程序。