System.Delegate.Combine 方法 (Delegate[])

方法描述

将委托数组的调用列表连接在一起。

语法定义(C# System.Delegate.Combine 方法 (Delegate[]) 的用法)

[ComVisibleAttribute(true)]
public static Delegate Combine(
	params Delegate[] delegates
)

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
delegates System-Delegate[] 要组合的委托数组。
返回值 System.Delegate 新的委托,该委托的调用列表将 delegates 数组中的委托的调用列表连接在一起。 如果 delegates 为 null,delegates 包含零个元素,或 delegates 中的每项均为 null,则返回 null。

提示和注释

如果 delegates 数组包含为 null 的项,则将忽略这些项。

调用列表中可包含重复项目,即引用同一对象上同一种方法的项目。

注意

赋值兼容的泛型委托由于变化不一定可组合。 若要可组合,类型必须完全匹配。 例如,假设一个名为 Derived 的类派生自名为 Base 的类。 类型为 Action(在 Visual Basic 中为 Action(Of Base))的委托可以赋值给类型为 Action 的变量,如泛型中的协变和逆变中所述,但是无法组合两个委托,因为类型不完全匹配。

Combine 对于创建在每次发生事件时都调用多种方法的事件处理程序非常有用。

System.Delegate.Combine 方法 (Delegate[])例子


异常

异常 异常描述
ArgumentException 并非 delegates 中的所有非空项都是同一委托类型的实例。

命名空间

namespace: System

程序集: mscorlib(在 mscorlib.dll 中)

版本信息

.NET Framework 受以下版本支持:4、3.5、3.0、2.0、1.1、1.0 .NET Framework Client Profile 受以下版本支持:4、3.5 SP1

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。