FieldInfo.SetValue FieldInfo.SetValue FieldInfo.SetValue FieldInfo.SetValue Method

Définit la valeur du champ pris en charge par l’objet donné.Sets the value of the field supported by the given object.

public:
 void SetValue(System::Object ^ obj, System::Object ^ value);

public void SetValue (object obj, object value);

member this.SetValue : obj * obj -> unit

Public Sub SetValue (obj As Object, value As Object)

Paramètres

Implémente

Exceptions

Exemples

L’exemple suivant définit la valeur d’un champ, obtient et affiche la valeur, modifie le champ et affiche le résultat.The following example sets the value of a field, gets and displays the value, modifies the field, and displays the result.

using namespace System;
using namespace System::Reflection;
using namespace System::Globalization;

public ref class Example
{
private:
   String^ myString;

public:
   Example()
   {
      myString = "Old value";
   }

   property String^ StringProperty 
   {
      String^ get()
      {
         return myString;
      }
   }
};

int main()
{
    Example^ myObject = gcnew Example;
    Type^ myType = Example::typeid;
    FieldInfo^ myFieldInfo = myType->GetField( "myString", 
        BindingFlags::NonPublic | BindingFlags::Instance);
      
    // Display the string before applying SetValue to the field.
    Console::WriteLine( "\nThe field value of myString is \"{0}\".", 
        myFieldInfo->GetValue( myObject ) );
    // Display the SetValue signature used to set the value of a field.
    Console::WriteLine( "Applying SetValue(Object, Object)." );

    // Change the field value using the SetValue method. 
    myFieldInfo->SetValue( myObject, "New value" );     
    // Display the string after applying SetValue to the field.
    Console::WriteLine( "The field value of mystring is \"{0}\".", 
        myFieldInfo->GetValue(myObject));
}
/* This code produces the following output:

The field value of myString is "Old value".
Applying SetValue(Object, Object).
The field value of mystring is "New value".
 */

using System;
using System.Reflection;
using System.Globalization;

public class Example
{
    private string myString;
    public Example()
    {
        myString = "Old value";
    }

    public string StringProperty
    {
        get
        {
            return myString;
        }
    }
}

public class FieldInfo_SetValue
{
    public static void Main()
    {
        Example myObject = new Example();
        Type myType = typeof(Example);
        FieldInfo myFieldInfo = myType.GetField("myString", 
            BindingFlags.NonPublic | BindingFlags.Instance); 

        // Display the string before applying SetValue to the field.
        Console.WriteLine( "\nThe field value of myString is \"{0}\".", 
        myFieldInfo.GetValue(myObject)); 
        // Display the SetValue signature used to set the value of a field.
        Console.WriteLine( "Applying SetValue(Object, Object)."); 
   
        // Change the field value using the SetValue method. 
        myFieldInfo.SetValue(myObject, "New value"); 
        // Display the string after applying SetValue to the field.
        Console.WriteLine( "The field value of mystring is \"{0}\".", 
            myFieldInfo.GetValue(myObject));
    }
}

/* This code example produces the following output:

The field value of myString is "Old value".
Applying SetValue(Object, Object).
The field value of mystring is "New value".
 */

Imports System.Reflection
Imports System.Globalization

Public Class Example
   Private myString As String
   
   Public Sub New()
      myString = "Old value"
   End Sub 
   
   ReadOnly Property StringProperty() As String
      Get
         Return myString
      End Get
   End Property
End Class 


Public Module FieldInfo_SetValue
   
   Sub Main()

        Dim myObject As New Example()
        Dim myType As Type = GetType(Example)
        Dim myFieldInfo As FieldInfo = myType.GetField("myString", _
           BindingFlags.NonPublic Or BindingFlags.Instance)

        ' Display the string before applying SetValue to the field.
        Console.WriteLine(vbCrLf & "The field value of myString is ""{0}"".", _
            myFieldInfo.GetValue(myObject))
        ' Display the SetValue signature used to set the value of a field.
        Console.WriteLine("Applying SetValue(Object, Object).")

        ' Change the field value using the SetValue method. 
        myFieldInfo.SetValue(myObject, "New value")
        ' Display the string after applying SetValue to the field.
        Console.WriteLine("The field value of mystring is ""{0}"".", _
            myFieldInfo.GetValue(myObject))

    End Sub 
End Module

' This code example produces the following output:
' The field value of myString is "Old value".
' Applying SetValue(Object, Object).
' The field value of mystring is "New value".

Remarques

Cette méthode est assignée value au champ réfléchi par cette instance sur l’objet. objThis method will assign value to the field reflected by this instance on object obj. Si le champ est statique, obj sera ignoré.If the field is static, obj will be ignored. Pour les champs non statiques obj , doit être une instance d’une classe qui hérite ou déclare le champ.For non-static fields, obj should be an instance of a class that inherits or declares the field. La nouvelle valeur est passée en tant Objectque.The new value is passed as an Object. Par exemple, si le type du champ est booléen, une instance de Object avec la valeur booléenne appropriée est passée.For example, if the field's type is Boolean, an instance of Object with the appropriate Boolean value is passed. Avant de définir la valeur SetValue , vérifie si l’utilisateur dispose de l’autorisation d’accès.Before setting the value, SetValue checks to see if the user has access permission. Cette dernière méthode est une méthode pratique pour appeler la méthode SetValue suivante.This final method is a convenience method for calling the following SetValue method.

Sécurité

ReflectionPermission
en cas d’appel à liaison tardive via des mécanismes InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[])tels que.when invoked late-bound through mechanisms such as InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]). Énumération associée : MemberAccess.Associated enumeration: MemberAccess.

SecurityPermission
pour la mise à jour des champs init uniquement.for updating init-only fields. Énumération associée : SerializationFormatter.Associated enumeration: SerializationFormatter.

En cas de substitution dans une classe dérivée, définit la valeur du champ pris en charge par l'objet donné.When overridden in a derived class, sets the value of the field supported by the given object.

public:
 abstract void SetValue(System::Object ^ obj, System::Object ^ value, System::Reflection::BindingFlags invokeAttr, System::Reflection::Binder ^ binder, System::Globalization::CultureInfo ^ culture);

public abstract void SetValue (object obj, object value, System.Reflection.BindingFlags invokeAttr, System.Reflection.Binder binder, System.Globalization.CultureInfo culture);

abstract member SetValue : obj * obj * System.Reflection.BindingFlags * System.Reflection.Binder * System.Globalization.CultureInfo -> unit

Paramètres

Implémente

Exceptions

Remarques

Cette méthode est assignée value au champ réfléchi par cette instance sur. objThis method will assign value to the field reflected by this instance on obj. Si le champ est statique, obj sera ignoré.If the field is static, obj will be ignored. Pour les champs non statiques obj , doit être une instance d’une classe qui hérite ou déclare le champ.For non-static fields, obj should be an instance of a class that inherits or declares the field. La nouvelle valeur est passée en tant Objectque.The new value is passed as an Object. Par exemple, si le type du champ est Boolean, une instance de Object avec la valeur booléenne appropriée est passée.For example, if the field's type is Boolean, an instance of Object with the appropriate Boolean value is passed. Avant de définir la valeur SetValue , vérifie si l’utilisateur dispose de l’autorisation d’accès.Before setting the value, SetValue checks to see if the user has access permission.

Sécurité

ReflectionPermission
en cas d’appel à liaison tardive via des mécanismes InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[])tels que.when invoked late-bound through mechanisms such as InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]). Énumération associée : MemberAccess.Associated enumeration: MemberAccess.

SecurityPermission
pour la mise à jour des champs init uniquement.for updating init-only fields. Énumération associée : SerializationFormatter.Associated enumeration: SerializationFormatter.