FieldInfo.SetValue Metoda

Definice

Obor názvů:

System.Reflection

Sestavení:

netstandard.dll, System.Runtime.dll

Nastaví hodnotu pole pro daný objekt na danou hodnotu.

Přetížení

Name	Description
SetValue(Object, Object)	Nastaví hodnotu pole podporovaného daným objektem.
SetValue(Object, Object, BindingFlags, Binder, CultureInfo)	Při přepsání v odvozené třídě nastaví hodnotu pole podporované daným objektem.

SetValue(Object, Object)

Zdroj:

FieldInfo.cs

Nastaví hodnotu pole podporovaného daným objektem.

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)

Parametry

obj

Object

Objekt, jehož hodnota pole bude nastavena.

value

Object

Hodnota, která se má přiřadit k poli.

Výjimky

FieldAccessException

Volající nemá oprávnění pro přístup k tomuto poli.

Poznámka: V .NET pro aplikace pro Windows Store nebo v přenosné knihovně tříd zachyťte výjimku základní třídy , místo MemberAccessExceptiontoho.

TargetException

Parametr obj je null a pole je polem instance.

Poznámka: V .NET pro aplikace pro Windows Store nebo v knihovně přenosných tříd místo toho zachyťte Exception .

ArgumentException

Pole v objektu neexistuje.

nebo

Parametr value nelze převést a uložit do pole.

Příklady

Následující příklad nastaví hodnotu pole, získá a zobrazí hodnotu, upraví pole a zobrazí výsledek.

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

Poznámky

Tato metoda přiřadí value k poli, které se projeví touto instancí v objektu obj. Pokud je pole statické, obj bude ignorováno. Pro nestatická pole by měla být instance třídy, obj která dědí nebo deklaruje pole. Nová hodnota se předává jako Object. Pokud je například typ pole boolean, předá se instance Object s příslušnou logickou hodnotou. Před nastavením hodnoty zkontroluje, SetValue jestli má uživatel přístupové oprávnění. Tato konečná metoda je metoda usnadnění volání následující SetValue metody.

Tuto metodu nelze použít k spolehlivému nastavení hodnot statických, inicializačních polí (readonly v jazyce C#). Ve verzích .NET se vyvolá výjimka, pokud se pokusíte nastavit hodnotu v statickém poli pouze inicializační.

Poznámka:

Plně důvěryhodný kód má oprávnění potřebná pro přístup k privátním konstruktorům, metodám, polím a vlastnostem pomocí reflexe a jejich vyvolání.

Poznámka:

Tuto metodu lze použít pro přístup k neveřejným členům, pokud byl volající udělen ReflectionPermission příznakem ReflectionPermissionFlag.RestrictedMemberAccess a pokud je sada udělení nepřístupných členů omezena na sadu grantů volajícího nebo její podmnožinu. (Viz aspekty zabezpečení pro reflexi.)

Pokud chcete tuto funkci použít, měla by vaše aplikace cílit na rozhraní .NET Framework 3.5 nebo novější.

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

Zdroj:

FieldInfo.cs

Při přepsání v odvozené třídě nastaví hodnotu pole podporované daným objektem.

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)

Parametry

obj

Object

Objekt, jehož hodnota pole bude nastavena.

value

Object

Hodnota, která se má přiřadit k poli.

invokeAttr

BindingFlags

Pole Binder , které určuje požadovaný typ vazby (například Binder.CreateInstanceBinder.ExactBinding).

binder

Binder

Sada vlastností, která umožňuje vazby, převod typů argumentů a vyvolání členů prostřednictvím reflexe. Pokud binder je null, použije Binder.DefaultBinding se.

culture

CultureInfo

Předvolby softwaru konkrétní jazykové verze.

Výjimky

FieldAccessException

Volající nemá oprávnění pro přístup k tomuto poli.

TargetException

Parametr obj je null a pole je polem instance.

ArgumentException

Pole v objektu neexistuje.

nebo

Parametr value nelze převést a uložit do pole.

Poznámky

Tato metoda přiřadí value k poli, které se projeví touto instancí .obj Pokud je pole statické, obj bude ignorováno. Pro nestatická pole by měla být instance třídy, obj která dědí nebo deklaruje pole. Nová hodnota se předává jako Object. Pokud je Booleannapříklad typ pole , předá se instance Object s příslušnou logickou hodnotou. Před nastavením hodnoty zkontroluje, SetValue jestli má uživatel přístupové oprávnění.

Tuto metodu nelze použít k spolehlivému nastavení hodnot statických, inicializačních polí (readonly v jazyce C#). V .NET je vyvolán výjimka, pokud se pokusíte nastavit hodnotu na statickém inicializačním poli.

Poznámka:

Plně důvěryhodný kód má oprávnění potřebná pro přístup k privátním konstruktorům, metodám, polím a vlastnostem pomocí reflexe a jejich vyvolání.

Poznámka:

Tuto metodu lze použít pro přístup k neveřejným členům, pokud byl volající udělen ReflectionPermission příznakem ReflectionPermissionFlag.RestrictedMemberAccess a pokud je sada udělení nepřístupných členů omezena na sadu grantů volajícího nebo její podmnožinu. (Viz aspekty zabezpečení pro reflexi.)