Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
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

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 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 .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0, 1.1, 1.0

Community Additions

ADD
Show:
© 2015 Microsoft