Overloads (Visual Basic)

  • 發行項

指定屬性或程序會重新宣告一或多個同名的現有屬性或程序。

備註

「多載」是一種做法，可將多個定義提供給相同範圍中指定的屬性或程序名稱。 利用不同的特徵標記宣告屬性或程序，有時稱為「依特徵標記隱藏」。

規則

  • 宣告內容。 您只能在屬性或程序宣告陳述式中使用 Overloads。

  • 合併的修飾元。 您不能在相同的程序宣告中同時指定 Overloads 與 Shadows。

  • 必要的差異。 此宣告中的「特徵標記」必須與其所多載每個屬性或程序的特徵標記不同。 簽章包含屬性或程序名稱，以及下列項目：

    • 參數的數目

    • 參數的順序

    • 參數的資料類型

    • 類型參數的數目 (適用於泛型程序)

    • 傳回型別 (僅適用於轉換運算子程序)

    所有多載必須有相同的名稱，但每個多載的名稱在一或多個上述方面中必須和其他多載不同。 這可讓編譯器在程式碼呼叫屬性或程序時可識別要使用的版本。

  • 不允許的差異。 變更下列一或多個項目，對於多載屬性或程序是無效的，因為它們屬於簽章：

    • 是否傳回值 (適用於程序)

    • 傳回值的資料類型 (除了轉換運算子之外)

    • 參數或型別參數的名稱

    • 類型參數上的條件約束 (適用於泛型程序)

    • 參數修飾詞關鍵字 (例如 ByRef 或 Optional)

    • 屬性或程序修飾詞關鍵字 (例如 Public 或 Shared)

  • 選擇性修飾詞。 當您在相同類別中定義多個多載的屬性或程序時，您不必使用 Overloads 修飾詞。 不過，如果您在其中一個宣告中使用 Overloads，您必須在全部的宣告中使用它。

  • 遮蔽和多載。 Overloads 也可用來遮蔭基底類別中的現有成員或多載成員集合。 以此方式使用 Overloads 時，即表示您會宣告同名的屬性或方法和相同的參數清單作為基底類別成員，而且您並未提供 Shadows 關鍵字。

如果您使用 Overrides，編譯器會隱含地新增 Overloads，讓程式庫 API 更容易使用 C#。

Overloads 修飾詞可用於以下內容：

另請參閱