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 MustOverride Sub SetValue (
	obj As Object,
	value As Object,
	invokeAttr As BindingFlags,
	binder As Binder,
	culture As CultureInfo
)

Parameters

obj
Type: System.Object

The object whose field value will be set.

value
Type: System.Object

The value to assign to the field.

invokeAttr
Type: System.Reflection.BindingFlags

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

binder
Type: System.Reflection.Binder

A set of properties that enables the binding, coercion of argument types, and invocation of members through reflection. If binder is null, then Binder.DefaultBinding is used.

culture
Type: System.Globalization.CultureInfo

The software preferences of a particular culture.

Exception Condition
FieldAccessException

The caller does not have permission to access this field.

TargetException

The obj parameter is null 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.

System_CAPS_noteNote

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

System_CAPS_noteNote

Starting with the .NET Framework 2.0 Service Pack 1, this method can be used to access non-public members if the caller has been granted ReflectionPermission with the ReflectionPermissionFlag.RestrictedMemberAccess 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 .NET Framework 3.5 or later.

ReflectionPermission

for accessing non-public fields when the grant set of the non-public members is restricted to the caller's grant set, or a subset thereof. Associated enumeration: ReflectionPermissionFlag.RestrictedMemberAccess

ReflectionPermission

for accessing non-public fields regardless of their grant set. Associated enumeration: ReflectionPermissionFlag.MemberAccess

ReflectionPermission

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

SecurityPermission

for updating init-only fields. Associated enumeration: SecurityPermissionFlag.SerializationFormatter.

.NET Framework
Available since 1.1
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Return to top
Show: