Delegate.Combine 方法

定義

命名空間:

System

組件:

System.Runtime.dll

組件:

netstandard.dll

組件:

mscorlib.dll

串連指定多點傳送 (可結合的) 委派的引動過程清單。

多載

Combine(Delegate[])	串連委派陣列的引動過程清單。
Combine(Delegate, Delegate)	串連兩個委派的引動過程清單。

Combine(Delegate[])

串連委派陣列的引動過程清單。

public:
 static Delegate ^ Combine(... cli::array <Delegate ^> ^ delegates);

public:
 static Delegate ^ Combine(cli::array <Delegate ^> ^ delegates);

public static Delegate Combine (params Delegate[] delegates);

public static Delegate? Combine (params Delegate?[]? delegates);

public static Delegate Combine (Delegate[] delegates);

[System.Runtime.InteropServices.ComVisible(true)]
public static Delegate Combine (params Delegate[] delegates);

static member Combine : Delegate[] -> Delegate

[<System.Runtime.InteropServices.ComVisible(true)>]
static member Combine : Delegate[] -> Delegate

Public Shared Function Combine (ParamArray delegates As Delegate()) As Delegate

Public Shared Function Combine (delegates As Delegate()) As Delegate

參數

delegates

Delegate[]

要結合的委派陣列。

傳回

Delegate

具有引動過程清單的新委派，這個清單可串連 delegates 陣列中委派的引動過程清單。 如果 delegates 是 null、delegates 包含零個項目，或者 delegates 中的每個項目都是 null，則會傳回 null。

屬性

ComVisibleAttribute

例外狀況

ArgumentException

並非 delegates 中的所有非 null 項目都是相同委派類型的執行個體。

備註

如果 delegates 陣列包含的專案為 null ，則會忽略這些專案。

調用清單可能包含重複的專案;亦即，在相同物件上參考相同方法的專案。

注意

因為變異數不一定可組合，所以與指派相容的泛型委派。 若要加以組合，類型必須完全相符。 例如，假設名為的類別 Derived 衍生自名為的類別 Base 。 您 Action<Base> Action(Of Base) 可以將 Visual Basic) 中 (類型的委派指派給類型的變數（如共變數和反變數中所述）， Action<Derived> 但無法合併這兩個委派，因為類型不完全相符。

Combine 適用于建立事件處理常式，以便在每次發生事件時呼叫多個方法。

另請參閱

• MulticastDelegate
• CombineImpl(Delegate)

Combine(Delegate, Delegate)

串連兩個委派的引動過程清單。

public:
 static Delegate ^ Combine(Delegate ^ a, Delegate ^ b);

public static Delegate Combine (Delegate a, Delegate b);

public static Delegate? Combine (Delegate? a, Delegate? b);

static member Combine : Delegate * Delegate -> Delegate

Public Shared Function Combine (a As Delegate, b As Delegate) As Delegate

參數

a

Delegate

引動過程清單首先到達的委派。

b

Delegate

引動過程清單最後到達的委派。

傳回

Delegate

具有引動過程清單的新委派，這個清單可以該順序串連 a 和 b 的引動過程清單。 如果 b 為 null，則會傳回 a；如果 a 為 Null 參考，則會傳回 b；如果 a 和 b 兩者都是 Null 參考，則會傳回 Null 參考。

例外狀況

ArgumentException

a 和 b 都不是 null，而且 a 和 b 不是相同委派類型的執行個體。

備註

調用清單可能包含重複的專案;亦即，在相同物件上參考相同方法的專案。

注意

因為變異數不一定可組合，所以與指派相容的泛型委派。 若要加以組合，類型必須完全相符。 例如，假設名為的類別 Derived 衍生自名為的類別 Base 。 您 Action<Base> Action(Of Base) 可以將 Visual Basic) 中 (類型的委派指派給類型的變數（如共變數和反變數中所述）， Action<Derived> 但無法合併這兩個委派，因為類型不完全相符。

Combine 適用于建立事件處理常式，以便在每次發生事件時呼叫多個方法。

另請參閱

• MulticastDelegate
• CombineImpl(Delegate)