FieldInfo.SetValue Método

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

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)

Parâmetros

Implementações

Exceções

Exemplos

O exemplo seguinte define o valor de um campo, obtém e apresenta o valor, modifica o campo e apresenta o resultado.

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".

Observações

Este método atribuirá value ao campo refletido por esta instância no objeto obj. Se o campo for estático, obj será ignorado. Para corpos não estáticos, obj deve ser uma instância de uma classe que herda ou declara o corpo. O novo valor é passado como um Object. Por exemplo, se o tipo do campo for Booleano, passa uma instância de Object com o valor Booleano apropriado. Antes de definir o valor, SetValue verifica se o utilizador tem permissão de acesso. Este último método é um método de conveniência para chamar o seguinte SetValue método.

Este método não pode ser usado para definir valores de campos estáticos, apenas de entrada (readonly em C#) de forma fiável. Nas versões .NET, uma exceção é lançada se tentar definir um valor num campo estático, apenas init.

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

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

Parâmetros

Implementações

Exceções

Observações

Este método atribuirá value ao campo refletido por esta instância em obj. Se o campo for estático, obj será ignorado. Para corpos não estáticos, obj deve ser uma instância de uma classe que herda ou declara o corpo. O novo valor é passado como um Object. Por exemplo, se o tipo do campo for Boolean, uma instância de Object com o valor Booleano apropriado é passada. Antes de definir o valor, SetValue verifica se o utilizador tem permissão de acesso.

Este método não pode ser usado para definir valores de campos estáticos, apenas de entrada (readonly em C#) de forma fiável. No .NET, uma exceção é lançada se tentar definir um valor num campo estático, apenas init.