Delegate.Combine 方法

定义

命名空间:

System

程序集:

System.Runtime.dll

连接指定多播（可组合）委托的调用列表。

重载

Combine(Delegate[])	连接委托数组的调用列表。
Combine(Delegate, Delegate)	连接两个委托的调用列表。

Combine(Delegate[])

Source:

Delegate.cs

连接委托数组的调用列表。

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

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

static member Combine : Delegate[] -> Delegate

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

参数

delegates

Delegate[]

要组合的委托数组。

返回

Delegate

一个新委托，其中包含一个调用列表，该列表连接 delegates 数组中委托的调用列表。 如果 nulldelegates，则返回 null;如果 delegates 包含零个元素，或者 delegates 中的每个条目 null。

例外

ArgumentException

并不是 delegates 中的所有非 null 条目都是同一委托类型的实例。

注解

如果 delegates 数组包含 null的条目，则忽略这些条目。

调用列表可以包含重复的条目;也就是说，引用同一对象上相同方法的条目。

注意

由于方差而与分配兼容的泛型委托不一定是可组合的。 若要组合，类型必须完全匹配。 例如，假设名为 Derived 的类派生自名为 Base的类。 协变和逆变中所述，可以将类型 Action<Base>（visual Basic 中的Action(Of Base)）的委托分配给类型 Action<Derived>变量，但无法组合这两个委托，因为类型不匹配。

Combine 可用于创建每次发生事件时调用多个方法的事件处理程序。

另请参阅

• MulticastDelegate
• CombineImpl(Delegate)

Combine(Delegate, Delegate)

Source:

Delegate.cs

连接两个委托的调用列表。

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 的调用列表。 如果 bnull，则返回 a;如果 a 为 null 引用，则返回 b;如果 a 和 b 均为 null 引用，则返回 null 引用。

例外

ArgumentException

a 和 b 都不 null，a 和 b 不是同一委托类型的实例。

注解

调用列表可以包含重复的条目;也就是说，引用同一对象上相同方法的条目。

注意

由于方差而与分配兼容的泛型委托不一定是可组合的。 若要组合，类型必须完全匹配。 例如，假设名为 Derived 的类派生自名为 Base的类。 协变和逆变中所述，可以将类型 Action<Base>（visual Basic 中的Action(Of Base)）的委托分配给类型 Action<Derived>变量，但无法组合这两个委托，因为类型不匹配。

Combine 可用于创建每次发生事件时调用多个方法的事件处理程序。

另请参阅

• MulticastDelegate
• CombineImpl(Delegate)