Export (0) Print
Expand All

Delegate.Combine Method (Delegate[])

Concatenates the invocation lists of an array of delegates.

Namespace: System
Assembly: mscorlib (in mscorlib.dll)

[ComVisibleAttribute(true)] 
public static Delegate Combine (
	params Delegate[] delegates
)
/** @attribute ComVisibleAttribute(true) */ 
public static Delegate Combine (
	Delegate[] delegates
)
ComVisibleAttribute(true) 
public static function Combine (
	... delegates : Delegate[]
) : Delegate
Not applicable.

Parameters

delegates

The array of delegates to combine.

Return Value

A new delegate with an invocation list that concatenates the invocation lists of the delegates in the delegates array. Returns a null reference (Nothing in Visual Basic) if delegates is a null reference (Nothing in Visual Basic), if delegates contains zero elements, or if every entry in delegates is a null reference (Nothing in Visual Basic).

Exception typeCondition

ArgumentException

Not all the non-null entries in delegates are instances of the same delegate type.

If the delegates array contains entries that are a null reference (Nothing in Visual Basic), those entries are ignored.

The invocation list can contain duplicate entries; that is, entries that refer to the same method on the same object.

Combine is useful for creating event handlers that call multiple methods each time an event occurs.

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

Community Additions

ADD
Show:
© 2014 Microsoft