Delegate.Combine Method (Delegate[]) (System)

.NET Framework Class Library

Delegate..::.Combine Method (array<Delegate>[]()[])

Concatenates the invocation lists of an array of delegates.

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

Syntax

Visual Basic (Declaration)

<ComVisibleAttribute(True)> _
Public Shared Function Combine ( _
    ParamArray delegates As Delegate() _
) As Delegate

Visual Basic (Usage)

Dim delegates As Delegate()
Dim returnValue As [Delegate]

returnValue = Delegate.Combine(delegates)

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

Visual C++

[ComVisibleAttribute(true)]
public:
static Delegate^ Combine(
    ... array<Delegate^>^ delegates
)

JScript

public static function Combine(
    ... delegates : Delegate[]
) : Delegate

Parameters

delegates: Type: array<System..::.Delegate>[]()[]
The array of delegates to combine.

Return Value

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

Exceptions

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

Remarks

If the delegates array contains entries that are nullNothingnullptra 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.

.NET Framework Security

ReflectionPermission
when invoked late-bound through mechanisms such as Type..::.InvokeMember. Associated enumeration: ReflectionPermissionFlag..::.MemberAccess

Platforms

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

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

Reference