Export (0) Print
Expand All

FieldInfo.SetValue Method (Object, Object, BindingFlags, Binder, CultureInfo)

When overridden in a derived class, sets the value of the field supported by the given object.

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

public abstract void SetValue (
	Object obj,
	Object value,
	BindingFlags invokeAttr,
	Binder binder,
	CultureInfo culture
)
public abstract void SetValue (
	Object obj, 
	Object value, 
	BindingFlags invokeAttr, 
	Binder binder, 
	CultureInfo culture
)
public abstract function SetValue (
	obj : Object, 
	value : Object, 
	invokeAttr : BindingFlags, 
	binder : Binder, 
	culture : CultureInfo
)
Not applicable.

Parameters

obj

The object whose field value will be set.

value

The value to assign to the field.

invokeAttr

A field of Binder that specifies the type of binding that is desired (for example, Binder.CreateInstance or Binder.ExactBinding).

binder

A set of properties that enables the binding, coercion of argument types, and invocation of members through reflection. If binder is a null reference (Nothing in Visual Basic), then Binder.DefaultBinding is used.

culture

The software preferences of a particular culture.

Exception typeCondition

FieldAccessException

The caller does not have permission to access this field.

TargetException

The obj parameter is a null reference (Nothing in Visual Basic) and the field is an instance field.

ArgumentException

The field does not exist on the object.

-or-

The value parameter cannot be converted and stored in the field.

This method will assign value to the field reflected by this instance on obj. If the field is static, obj will be ignored. For non-static fields, obj should be an instance of a class that inherits or declares the field. The new value is passed as an Object. For example, if the field's type is Boolean, an instance of Object with the appropriate Boolean value is passed. Before setting the value, SetValue checks to see if the user has access permission.

NoteNote:

Fully trusted code has the permissions that are needed to access and invoke private constructors, methods, fields, and properties using reflection.

NoteNote:

Starting with the , this method can be used to access non-public members if the caller has been granted ReflectionPermission with the ReflectionPermissionFlag.ReflectionEmit flag and if the grant set of the non-public members 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.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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

.NET Compact Framework

Supported in: 2.0, 1.0

XNA Framework

Supported in: 1.0

Community Additions

ADD
Show:
© 2014 Microsoft