Delegate.Remove Method (System)

.NET Framework Class Library

Delegate..::.Remove Method

Removes the last occurrence of the invocation list of a delegate from the invocation list of another delegate.

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

Syntax

Visual Basic (Declaration)

Public Shared Function Remove ( _
    source As Delegate, _
    value As Delegate _
) As Delegate

Visual Basic (Usage)

Dim source As [Delegate]
Dim value As [Delegate]
Dim returnValue As [Delegate]

returnValue = Delegate.Remove(source, _
    value)

public static Delegate Remove(
    Delegate source,
    Delegate value
)

Visual C++

public:
static Delegate^ Remove(
    Delegate^ source, 
    Delegate^ value
)

JScript

public static function Remove(
    source : Delegate, 
    value : Delegate
) : Delegate

Parameters

source: Type: System..::.Delegate
The delegate from which to remove the invocation list of value.

value: Type: System..::.Delegate
The delegate that supplies the invocation list to remove from the invocation list of source.

Return Value

Type: System..::.Delegate
A new delegate with an invocation list formed by taking the invocation list of source and removing the last occurrence of the invocation list of value, if the invocation list of value is found within the invocation list of source. Returns source if value is nullNothingnullptra null reference (Nothing in Visual Basic) or if the invocation list of value is not found within the invocation list of source. Returns a null reference if the invocation list of value is equal to the invocation list of source or if source is a null reference.

Exceptions

Exception	Condition
MemberAccessException	The caller does not have access to the method represented by the delegate (for example, if the method is private).
ArgumentException	The delegate types do not match.

Remarks

If the invocation list of value matches a contiguous set of elements in the invocation list of source, then the invocation list of value is said to occur within the invocation list of source. If the invocation list of value occurs more than once in the invocation list of source, the last occurrence is removed.

Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows CE Platform Note: If the delegate types do not match, the .NET Compact Framework does not throw a ArgumentException but the operation fails.

.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, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360, Zune

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

.NET Compact Framework

Supported in: 3.5, 2.0, 1.0

XNA Framework

Supported in: 3.0, 2.0, 1.0

Reference