FieldInfo.SetValue Méthode

Référence

Définition

Espace de noms:: System.Reflection

Assembly:: System.Reflection.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Assigne à la valeur spécifiée la valeur du champ de l'objet donné.

Surcharges

SetValue(Object, Object)	Définit la valeur du champ pris en charge par l’objet donné.
SetValue(Object, Object, BindingFlags, Binder, CultureInfo)	En cas de substitution dans une classe dérivée, définit la valeur du champ pris en charge par l'objet donné.

SetValue(Object, Object)

Source:: FieldInfo.cs

Source:: FieldInfo.cs

Source:: FieldInfo.cs

Définit la valeur du champ pris en charge par l’objet donné.

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

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

public virtual void SetValue (object obj, object value);

public void SetValue (object? obj, object? value);

public void SetValue (object obj, object value);

abstract member SetValue : obj * obj -> unit
override this.SetValue : obj * obj -> unit

member this.SetValue : obj * obj -> unit

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

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

Paramètres

obj: Object

Objet dont la valeur de champ sera définie.

value: Object

La valeur à affecter au champ.

Implémente

SetValue(Object, Object)

Exceptions

FieldAccessException

L’appelant n’est pas autorisé à accéder à ce champ.

Remarque : Dans .NET pour les applications du Windows Store ou la bibliothèque de classes portable, interceptez l’exception de classe de base, MemberAccessException, à la place.

TargetException

Le obj paramètre est null et le champ est un champ d’instance.

Remarque : Dans .NET pour les applications du Windows Store ou la bibliothèque de classes portable, interceptez Exception à la place.

ArgumentException

Ce champ n'existe pas sur l’objet.

- ou -

Le paramètre value ne peut pas être converti et stocké dans le champ.

Exemples

L’exemple suivant définit la valeur d’un champ, obtient et affiche la valeur, modifie le champ et affiche le résultat.

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 affectée value au champ répercuté par cette instance sur l’objet obj. Si le champ est statique, obj est ignoré. Pour les champs non statiques, obj doit être une instance d’une classe qui hérite ou déclare le champ. La nouvelle valeur est passée en tant que Object. Par exemple, si le type du champ est Boolean, une instance de Object avec la valeur booléenne appropriée est passée. Avant de définir la valeur, SetValue vérifiez si l’utilisateur dispose d’une autorisation d’accès. Cette méthode finale est une méthode pratique pour appeler la méthode suivante SetValue .

Cette méthode ne peut pas être utilisée pour définir de manière fiable les valeurs des champs statiques init-only (readonly en C#). Dans .NET Core 3.0 et versions ultérieures, une exception est levée si vous tentez de définir une valeur sur un champ statique init uniquement.

Remarque

Le code entièrement fiable dispose des autorisations nécessaires pour accéder aux constructeurs, méthodes, champs et propriétés privés et les appeler à l’aide de la réflexion.

Remarque

À compter de .NET Framework 2.0 Service Pack 1, cette méthode peut être utilisée pour accéder aux membres non publics si l’appelant a reçu ReflectionPermission l’indicateur ReflectionPermissionFlag.RestrictedMemberAccess et si le jeu d’octrois des membres non publics est limité à l’ensemble d’octrois de l’appelant ou à un sous-ensemble de celui-ci. (Consultez Considérations relatives à la sécurité pour la réflexion.)

Pour utiliser cette fonctionnalité, votre application doit cibler .NET Framework 3.5 ou version ultérieure.

S’applique à

.NET 9 et autres versions

Produit	Versions
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

SetValue(Object, Object, BindingFlags, Binder, CultureInfo)

Source:: FieldInfo.cs

Source:: FieldInfo.cs

Source:: FieldInfo.cs

En cas de substitution dans une classe dérivée, définit la valeur du champ pris en charge par l'objet donné.

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);

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

Public MustOverride Sub SetValue (obj As Object, value As Object, invokeAttr As BindingFlags, binder As Binder, culture As CultureInfo)

Paramètres

obj: Object

Objet dont la valeur de champ sera définie.

value: Object

La valeur à affecter au champ.

invokeAttr: BindingFlags

Champ de Binder qui spécifie le type de liaison requis (par exemple, Binder.CreateInstance ou Binder.ExactBinding).

binder: Binder

Jeu de propriétés qui active la liaison, la contrainte des types d'arguments, ainsi que l'appel des membres à l'aide de la réflexion. Si binder est null, Binder.DefaultBinding est utilisé.

culture: CultureInfo

Préférences logicielles d'une culture spécifique.

Implémente

SetValue(Object, Object, BindingFlags, Binder, CultureInfo)

Exceptions

FieldAccessException

L’appelant n’est pas autorisé à accéder à ce champ.

TargetException

Le obj paramètre est null et le champ est un champ d’instance.

ArgumentException

Ce champ n'existe pas sur l’objet.

- ou -

Le paramètre value ne peut pas être converti et stocké dans le champ.

Remarques

Cette méthode est affectée value au champ reflété par cette instance sur obj. Si le champ est statique, obj est ignoré. Pour les champs non statiques, obj doit être une instance d’une classe qui hérite ou déclare le champ. La nouvelle valeur est passée en tant que Object. Par exemple, si le type du champ est Boolean, une instance de Object avec la valeur booléenne appropriée est passée. Avant de définir la valeur, SetValue vérifiez si l’utilisateur dispose d’une autorisation d’accès.

Remarque

Le code entièrement fiable dispose des autorisations nécessaires pour accéder aux constructeurs, méthodes, champs et propriétés privés et les appeler à l’aide de la réflexion.

Remarque

Pour utiliser cette fonctionnalité, votre application doit cibler .NET Framework 3.5 ou version ultérieure.

S’applique à

.NET 9 et autres versions

Produit	Versions
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

Partage via

FieldInfo.SetValue Méthode

Définition

Surcharges

SetValue(Object, Object)

Paramètres

Implémente

Exceptions

Exemples

Remarques

S’applique à

SetValue(Object, Object, BindingFlags, Binder, CultureInfo)

Paramètres

Implémente

Exceptions

Remarques

S’applique à

Ressources supplémentaires