This documentation is archived and is not being maintained.

Delegate.CreateDelegate Method (Type, Object, String, Boolean, Boolean)

Creates a delegate of the specified type that represents the specified instance method to invoke on the specified class instance, with the specified case-sensitivity and the specified behavior on failure to bind.

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

public static Delegate CreateDelegate (
	Type type,
	Object target,
	string method,
	bool ignoreCase,
	bool throwOnBindFailure
)
public static Delegate CreateDelegate (
	Type type, 
	Object target, 
	String method, 
	boolean ignoreCase, 
	boolean throwOnBindFailure
)
public static function CreateDelegate (
	type : Type, 
	target : Object, 
	method : String, 
	ignoreCase : boolean, 
	throwOnBindFailure : boolean
) : Delegate
Not applicable.

Parameters

type

The Type of delegate to create.

target

The class instance on which method is invoked.

method

The name of the instance method that the delegate is to represent.

ignoreCase

A Boolean indicating whether to ignore the case when comparing the name of the method.

throwOnBindFailure

true to throw an exception if method cannot be bound; otherwise, false.

Return Value

A delegate of the specified type that represents the specified instance method to invoke on the specified class instance.

Exception typeCondition

ArgumentNullException

type is a null reference (Nothing in Visual Basic).

-or-

target is a null reference (Nothing in Visual Basic).

-or-

method is a null reference (Nothing in Visual Basic).

ArgumentException

type does not inherit MulticastDelegate.

-or-

type is not a RuntimeType. See Runtime Types in Reflection.

-or-

method is not an instance method.

-or-

method cannot be bound, for example because it cannot be found, and throwOnBindFailure is true.

MissingMethodException

The Invoke method of type is not found.

MethodAccessException

The caller does not have the permissions necessary to access method.

This method creates delegates for instance methods only. An instance method is a method that is associated with an instance of a class; a static method is a method that is associated with the class itself.

NoteNote:

Starting with the , this method can be used to access non-public methods if the caller has been granted ReflectionPermission with the ReflectionPermissionFlag.ReflectionEmit flag and if the grant set of the non-public methods is restricted to the caller’s grant set, or a subset thereof. (See Security Considerations for Reflection.)

To use this functionality, your application should target the . For more information, see The .NET Framework 3.5 Architecture.

  • ReflectionPermission  for accessing a non-public method when the grant set of the non-public method is restricted to the caller's grant set, or a subset thereof. Associated enumeration: System.Security.Permissions.ReflectionPermissionFlag.RestrictedMemberAccess
  • ReflectionPermission  for accessing a non-public method regardless of its grant set. Associated enumeration: ReflectionPermissionFlag.MemberAccess
  • ReflectionPermission  when invoked late-bound through mechanisms such as Type.InvokeMember. Associated enumeration: ReflectionPermissionFlag.MemberAccess.

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
Show: