PropertyInfo.SetValue Metoda

  • Reference

Definice

Obor názvů:
System.Reflection
Sestavení:
System.Reflection.dll
Sestavení:
System.Runtime.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll

Nastaví hodnotu vlastnosti pro zadaný objekt.

Přetížení

SetValue(Object, Object)

Nastaví hodnotu vlastnosti zadaného objektu.
SetValue(Object, Object, Object[])

Nastaví hodnotu vlastnosti zadaného objektu s volitelnými hodnotami indexu pro vlastnosti indexu.
SetValue(Object, Object, BindingFlags, Binder, Object[], CultureInfo)

Při přepsání v odvozené třídě nastaví hodnotu vlastnosti pro zadaný objekt, který má zadanou vazbu, index a informace specifické pro jazykovou verzi.

SetValue(Object, Object)

Zdroj:
PropertyInfo.cs
Zdroj:
PropertyInfo.cs
Zdroj:
PropertyInfo.cs

Nastaví hodnotu vlastnosti zadaného objektu.

public:
 void SetValue(System::Object ^ obj, System::Object ^ value);
public void SetValue (object obj, 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 vlastnosti bude nastavena.

value
Object

Hodnota nové vlastnosti

Výjimky

ArgumentException

Příslušenství vlastnosti set se nenašlo.

-nebo-

value nelze převést na typ PropertyType.

TargetException

Typ objektu obj neodpovídá cílovému typu nebo vlastnost je vlastnost instance, ale obj je null.

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

MethodAccessException

Došlo k neoprávněnému pokusu o přístup k privátní nebo chráněné metodě uvnitř třídy.

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

TargetInvocationException

Při nastavování hodnoty vlastnosti došlo k chybě. Vlastnost InnerException označuje důvod chyby.

Příklady

Následující příklad deklaruje třídu s názvem Example s jednou static (Shared v jazyce Visual Basic) a jednou vlastností instance. Příklad používá metodu SetValue(Object, Object) ke změně původních hodnot vlastností a zobrazí původní a konečné hodnoty.

using namespace System;
using namespace System::Reflection;

ref class Example
{
private:
    int static _sharedProperty = 41;
    int _instanceProperty;


public:
    Example()
    {
        _instanceProperty = 42;
    };

    static property int SharedProperty
    {
        int get() { return _sharedProperty; }
        void set(int value) { _sharedProperty = value; }
    };

    property int InstanceProperty 
    {
        int get() { return _instanceProperty; }
        void set(int value) { _instanceProperty = value; }
    };

};

void main()
{
    Console::WriteLine("Initial value of static property: {0}",
                       Example::SharedProperty);

    PropertyInfo^ piShared = 
        Example::typeid->GetProperty("SharedProperty");
    piShared->SetValue(nullptr, 76, nullptr);
                 
    Console::WriteLine("New value of static property: {0}",
                       Example::SharedProperty);


    Example^ exam = gcnew Example();

    Console::WriteLine("\nInitial value of instance property: {0}", 
            exam->InstanceProperty);

    PropertyInfo^ piInstance = 
        Example::typeid->GetProperty("InstanceProperty");
    piInstance->SetValue(exam, 37, nullptr);
                 
    Console::WriteLine("New value of instance property: {0}",
                       exam->InstanceProperty);
};

/* The example displays the following output:
      Initial value of static property: 41
      New value of static property: 76

      Initial value of instance property: 42
      New value of instance property: 37
 */

using System;
using System.Reflection;

class Example
{
    private static int _staticProperty = 41;
    private int _instanceProperty = 42;

    // Declare a public static property.
    public static int StaticProperty
    {
        get { return _staticProperty; }
        set { _staticProperty = value; }
    }

    // Declare a public instance property.
    public int InstanceProperty
    {
        get { return _instanceProperty; }
        set { _instanceProperty = value; }
    }

    public static void Main()
    {
        Console.WriteLine("Initial value of static property: {0}",
            Example.StaticProperty);

        // Get a type object that represents the Example type.
        Type examType = typeof(Example);

        // Change the static property value.
        PropertyInfo piShared = examType.GetProperty("StaticProperty");
        piShared.SetValue(null, 76);

        Console.WriteLine("New value of static property: {0}",
                          Example.StaticProperty);

        // Create an instance of the Example class.
        Example exam = new Example();

        Console.WriteLine("\nInitial value of instance property: {0}",
                          exam.InstanceProperty);

        // Change the instance property value.
        PropertyInfo piInstance = examType.GetProperty("InstanceProperty");
        piInstance.SetValue(exam, 37);

        Console.WriteLine("New value of instance property: {0}",
                          exam.InstanceProperty);
    }
}
// The example displays the following output:
//       Initial value of static property: 41
//       New value of static property: 76
//
//       Initial value of instance property: 42
//       New value of instance property: 37

Imports System.Reflection

Class Example
    Private Shared _sharedProperty As Integer = 41
    Private _instanceProperty As Integer = 42

    ' Declare a public static (shared) property.
    Public Shared Property SharedProperty As Integer
        Get 
            Return _sharedProperty
        End Get
        Set
            _sharedProperty = Value
        End Set
    End Property

    ' Declare a public instance property.
    Public Property InstanceProperty As Integer
        Get 
            Return _instanceProperty
        End Get
        Set
            _instanceProperty = Value
        End Set
    End Property

    Public Shared Sub Main()
        Console.WriteLine("Initial value of shared property: {0}",
                          Example.SharedProperty)

        ' Get a type object that represents the Example type.
        Dim examType As Type = GetType(Example)
        
        ' Change the static (shared) property value.
        Dim piShared As PropertyInfo = examType.GetProperty("SharedProperty")
        piShared.SetValue(Nothing, 76)
                 
        Console.WriteLine("New value of shared property: {0}",
                          Example.SharedProperty)
        Console.WriteLine()

        ' Create an instance of the Example class.
        Dim exam As New Example

        Console.WriteLine("Initial value of instance property: {0}",
                          exam.InstanceProperty)

        ' Change the instance property value.
        Dim piInstance As PropertyInfo = examType.GetProperty("InstanceProperty")
        piInstance.SetValue(exam, 37)
                 
        Console.WriteLine("New value of instance property: {0}", _
                          exam.InstanceProperty)
    End Sub
End Class
' The example displays the following output:
'       Initial value of shared property: 41
'       New value of shared property: 76
'
'       Initial value of instance property: 42
'       New value of instance property: 37

Poznámky

Přetížení SetValue(Object, Object) nastaví hodnotu neindexované vlastnosti. Chcete-li zjistit, zda je vlastnost indexována, zavolejte metodu GetIndexParameters . Pokud má výsledná matice 0 (nula) prvků, vlastnost není indexována. Chcete-li nastavit hodnotu indexované vlastnosti, zavolejte SetValue(Object, Object, Object[]) přetížení.

Pokud je typ vlastnosti tohoto PropertyInfo objektu typ hodnoty a value je null, vlastnost bude nastavena na výchozí hodnotu pro tento typ.

Toto je pohodlná metoda, která volá běhovou implementaci abstraktní SetValue(Object, Object, BindingFlags, Binder, Object[], CultureInfo) metody a určuje BindingFlags.Default pro BindingFlags parametr null , null pro BinderObject[], a null pro CultureInfo.

Chcete-li použít metodu SetValue , nejprve získejte Type objekt, který představuje třídu. Z objektu Typezískejte PropertyInfo objekt. Z objektu PropertyInfo zavolejte metodu SetValue .

Poznámka

Počínaje rozhraním .NET Framework 2.0 lze tuto metodu použít pro přístup k neveřejným členům, pokud byl volajícímu udělen ReflectionPermissionReflectionPermissionFlag.RestrictedMemberAccess příznak a pokud je sada udělení neveřejných členů omezena na sadu udělení volajícího nebo její podmnožinu. (Viz Aspekty zabezpečení pro reflexi.) Pokud chcete tuto funkci používat, měla by vaše aplikace cílit na rozhraní .NET Framework 3.5 nebo novější.

Platí pro

SetValue(Object, Object, Object[])

Zdroj:
PropertyInfo.cs
Zdroj:
PropertyInfo.cs
Zdroj:
PropertyInfo.cs

Nastaví hodnotu vlastnosti zadaného objektu s volitelnými hodnotami indexu pro vlastnosti indexu.

public:
 virtual void SetValue(System::Object ^ obj, System::Object ^ value, cli::array <System::Object ^> ^ index);
public virtual void SetValue (object obj, object value, object[] index);
public virtual void SetValue (object? obj, object? value, object?[]? index);
abstract member SetValue : obj * obj * obj[] -> unit
override this.SetValue : obj * obj * obj[] -> unit
Public Overridable Sub SetValue (obj As Object, value As Object, index As Object())

Parametry

obj
Object

Objekt, jehož hodnota vlastnosti bude nastavena.

value
Object

Hodnota nové vlastnosti

index
Object[]

Volitelné hodnoty indexu pro indexované vlastnosti. Tato hodnota by měla být null pro neindexované vlastnosti.

Implementuje

SetValue(Object, Object, Object[])

Výjimky

ArgumentException

Pole index neobsahuje požadovaný typ argumentů.

-nebo-

Příslušenství vlastnosti set se nenašlo.

-nebo-

value nelze převést na typ PropertyType.

TargetException

Objekt neodpovídá cílovému typu nebo vlastnost je vlastnost instance, ale obj je null.

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

TargetParameterCountException

Počet parametrů v index souboru neodpovídá počtu parametrů, které indexovaná vlastnost přijímá.

MethodAccessException

Došlo k neoprávněnému pokusu o přístup k privátní nebo chráněné metodě uvnitř třídy.

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

TargetInvocationException

Při nastavování hodnoty vlastnosti došlo k chybě. Například hodnota indexu zadaná pro indexovanou vlastnost je mimo rozsah. Vlastnost InnerException označuje důvod chyby.

Příklady

Následující příklad definuje třídu s názvem TestClass , která má vlastnost pro čtení i zápis s názvem Caption. Zobrazí výchozí hodnotu Caption vlastnosti, zavolá metodu SetValue pro změnu hodnoty vlastnosti a zobrazí výsledek.

using namespace System;
using namespace System::Reflection;

// Define a property.
public ref class TestClass
{
private:
   String^ caption;

public:
   TestClass()
   {
      caption = "A Default caption";
   }


   property String^ Caption 
   {
      String^ get()
      {
         return caption;
      }

      void set( String^ value )
      {
         if ( caption != value )
         {
            caption = value;
         }
      }

   }

};

int main()
{
   TestClass^ t = gcnew TestClass;
   
   // Get the type and PropertyInfo.
   Type^ myType = t->GetType();
   PropertyInfo^ pinfo = myType->GetProperty( "Caption" );
   
   // Display the property value, using the GetValue method.
   Console::WriteLine( "\nGetValue: {0}", pinfo->GetValue( t, nullptr ) );
   
   // Use the SetValue method to change the caption.
   pinfo->SetValue( t, "This caption has been changed.", nullptr );
   
   // Display the caption again.
   Console::WriteLine( "GetValue: {0}", pinfo->GetValue( t, nullptr ) );
   Console::WriteLine( "\nPress the Enter key to continue." );
   Console::ReadLine();
   return 0;
}

/*
This example produces the following output:
 
GetValue: A Default caption
GetValue: This caption has been changed

Press the Enter key to continue.
*/

using System;
using System.Reflection;

// Define a class with a property.
public class TestClass
{
    private string caption = "A Default caption";
    public string Caption
    {
        get { return caption; }
        set
        {
            if (caption != value)
            {
                caption = value;
            }
        }
    }
}

class TestPropertyInfo
{
    public static void Main()
    {
        TestClass t = new TestClass();

        // Get the type and PropertyInfo.
        Type myType = t.GetType();
        PropertyInfo pinfo = myType.GetProperty("Caption");

        // Display the property value, using the GetValue method.
        Console.WriteLine("\nGetValue: " + pinfo.GetValue(t, null));

        // Use the SetValue method to change the caption.
        pinfo.SetValue(t, "This caption has been changed.", null);

        //  Display the caption again.
        Console.WriteLine("GetValue: " + pinfo.GetValue(t, null));

        Console.WriteLine("\nPress the Enter key to continue.");
        Console.ReadLine();
    }
}

/*
This example produces the following output:

GetValue: A Default caption
GetValue: This caption has been changed

Press the Enter key to continue.
*/

Imports System.Reflection

' Define a class with a property.
Public Class TestClass
    Private myCaption As String = "A Default caption"

    Public Property Caption() As String
        Get
            Return myCaption
        End Get
        Set
            If myCaption <> value Then myCaption = value
        End Set
    End Property
End Class

Public Class TestPropertyInfo
    Public Shared Sub Main()
        Dim t As New TestClass()

        ' Get the type and PropertyInfo.
        Dim myType As Type = t.GetType()
        Dim pinfo As PropertyInfo = myType.GetProperty("Caption")

        ' Display the property value, using the GetValue method.
        Console.WriteLine(vbCrLf & "GetValue: " & pinfo.GetValue(t, Nothing))

        ' Use the SetValue method to change the caption.
        pinfo.SetValue(t, "This caption has been changed.", Nothing)

        ' Display the caption again.
        Console.WriteLine("GetValue: " & pinfo.GetValue(t, Nothing))

        Console.WriteLine(vbCrLf & "Press the Enter key to continue.")
        Console.ReadLine()
    End Sub
End Class

' This example produces the following output:
' 
'GetValue: A Default caption
'GetValue: This caption has been changed
'
'Press the Enter key to continue.

Všimněte si, že vzhledem k tomu Caption , že vlastnost není pole parametrů, index argument je null.

Následující příklad deklaruje třídu s názvem Example se třemi vlastnostmi: static vlastnost (Shared v jazyce Visual Basic), vlastnost instance a vlastnost indexované instance. Příklad používá metodu SetValue ke změně výchozích hodnot vlastností a zobrazí původní a konečné hodnoty.

Název, který se používá k vyhledání vlastnosti indexované instance s reflexí, se liší v závislosti na jazyce a atributech použitých na vlastnost.

  • V jazyce Visual Basic se název vlastnosti vždy používá k vyhledání vlastnosti s reflexí. Pomocí klíčového Default slova můžete vlastnost nastavit jako výchozí indexovanou vlastnost. V takovém případě můžete název při přístupu k vlastnosti vynechat, jako v tomto příkladu. Můžete také použít název vlastnosti.

  • V jazyce C# je vlastnost indexované instance výchozí vlastností s názvem indexer a název se nikdy nepoužívá při přístupu k vlastnosti v kódu. Ve výchozím nastavení je Itemnázev vlastnosti a tento název musíte použít při hledání vlastnosti s reflexí. Pomocí atributu IndexerNameAttribute můžete indexeru přiřadit jiný název. V tomto příkladu je IndexedInstancePropertynázev .

  • V jazyce C++ default lze specifikátor použít k vytvoření indexované vlastnosti jako výchozí indexované vlastnosti (indexer tříd). V takovém případě je Itemve výchozím nastavení název vlastnosti a tento název musíte použít při hledání vlastnosti s odrazem, jako v tomto příkladu. Atribut můžete použít IndexerNameAttribute k tomu, aby indexer třídy získal jiný název v reflexi, ale tento název nelze použít pro přístup k vlastnosti v kódu. K indexované vlastnosti, která není indexerem tříd, se přistupuje pomocí svého názvu, a to jak v kódu, tak v reflexi.

using namespace System;
using namespace System::Reflection;
using namespace System::Collections::Generic;

ref class Example
{
private:
    int static _sharedProperty = 41;
    int _instanceProperty;
    Dictionary<int, String^>^ _indexedInstanceProperty;

public:
    Example()
    {
        _instanceProperty = 42;
        _indexedInstanceProperty = gcnew Dictionary<int, String^>();
    };

    static property int SharedProperty
    {
        int get() { return _sharedProperty; }
        void set(int value) { _sharedProperty = value; }
    };

    property int InstanceProperty 
    {
        int get() { return _instanceProperty; }
        void set(int value) { _instanceProperty = value; }
    };

    // By default, the name of the default indexed property (class 
    // indexer) is Item, and that name must be used to search for the 
    // property with reflection. The property can be given a different
    // name by using the IndexerNameAttribute attribute.
    property String^ default[int]
    { 
        String^ get(int key) 
        { 
            String^ returnValue;
            if (_indexedInstanceProperty->TryGetValue(key, returnValue))
            {
                return returnValue;
            }
            else
            {
                return nullptr;
            }
        }
        void set(int key, String^ value)
        {
            if (value == nullptr)
            {
                throw gcnew ArgumentNullException( 
                    "IndexedInstanceProperty value can be an empty string, but it cannot be null.");
            }
            else
            {
                if (_indexedInstanceProperty->ContainsKey(key))
                {
                    _indexedInstanceProperty[key] = value;
                }
                else
                {
                    _indexedInstanceProperty->Add(key, value);
                }
            }
        }
    };
};

void main()
{
    Console::WriteLine("Initial value of class-level property: {0}", 
        Example::SharedProperty);

    PropertyInfo^ piShared = 
        Example::typeid->GetProperty("SharedProperty");
    piShared->SetValue(nullptr, 76, nullptr);
                 
    Console::WriteLine("Final value of class-level property: {0}", 
        Example::SharedProperty);


    Example^ exam = gcnew Example();

    Console::WriteLine("\nInitial value of instance property: {0}", 
            exam->InstanceProperty);

    PropertyInfo^ piInstance = 
        Example::typeid->GetProperty("InstanceProperty");
    piInstance->SetValue(exam, 37, nullptr);
                 
    Console::WriteLine("Final value of instance property: {0}", 
        exam->InstanceProperty);


    exam[17] = "String number 17";
    exam[46] = "String number 46";
    exam[9] = "String number 9";

    Console::WriteLine(
        "\nInitial value of indexed instance property(17): '{0}'", 
        exam[17]);

    // By default, the name of the default indexed property (class 
    // indexer) is Item, and that name must be used to search for the 
    // property with reflection. The property can be given a different
    // name by using the IndexerNameAttribute attribute.
    PropertyInfo^ piIndexedInstance =
        Example::typeid->GetProperty("Item");
    piIndexedInstance->SetValue(
            exam, 
            "New value for string number 17", 
            gcnew array<Object^> { 17 });
                 
    Console::WriteLine("Final value of indexed instance property(17): '{0}'", 
        exam[17]);
};

/* This example produces the following output:

Initial value of class-level property: 41
Final value of class-level property: 76

Initial value of instance property: 42
Final value of instance property: 37

Initial value of indexed instance property(17): 'String number 17'
Final value of indexed instance property(17): 'New value for string number 17'
 */

using System;
using System.Reflection;
using System.Collections.Generic;
using System.Runtime.CompilerServices;

class Example
{
    private static int _staticProperty = 41;
    public static int StaticProperty
    {
        get
        {
            return _staticProperty;
        }
        set
        {
            _staticProperty = value;
        }
    }

    private int _instanceProperty = 42;
    public int InstanceProperty
    {
        get
        {
            return _instanceProperty;
        }
        set
        {
            _instanceProperty = value;
        }
    }

    private Dictionary<int, string> _indexedInstanceProperty =
        new Dictionary<int, string>();
    // By default, the indexer is named Item, and that name must be used
    // to search for the property. In this example, the indexer is given
    // a different name by using the IndexerNameAttribute attribute.
    [IndexerNameAttribute("IndexedInstanceProperty")]
    public string this[int key]
    {
        get
        {
            string returnValue = null;
            if (_indexedInstanceProperty.TryGetValue(key, out returnValue))
            {
                return returnValue;
            }
            else
            {
                return null;
            }
        }
        set
        {
            if (value == null)
            {
                throw new ArgumentNullException("IndexedInstanceProperty value can be an empty string, but it cannot be null.");
            }
            else
            {
                if (_indexedInstanceProperty.ContainsKey(key))
                {
                    _indexedInstanceProperty[key] = value;
                }
                else
                {
                    _indexedInstanceProperty.Add(key, value);
                }
            }
        }
    }

    public static void Main()
    {
        Console.WriteLine("Initial value of class-level property: {0}",
            Example.StaticProperty);

        PropertyInfo piShared = typeof(Example).GetProperty("StaticProperty");
        piShared.SetValue(null, 76, null);

        Console.WriteLine("Final value of class-level property: {0}",
            Example.StaticProperty);

        Example exam = new Example();

        Console.WriteLine("\nInitial value of instance property: {0}",
            exam.InstanceProperty);

        PropertyInfo piInstance =
            typeof(Example).GetProperty("InstanceProperty");
        piInstance.SetValue(exam, 37, null);

        Console.WriteLine("Final value of instance property: {0}",
            exam.InstanceProperty);

        exam[17] = "String number 17";
        exam[46] = "String number 46";
        exam[9] = "String number 9";

        Console.WriteLine(
            "\nInitial value of indexed instance property(17): '{0}'",
            exam[17]);

        // By default, the indexer is named Item, and that name must be used
        // to search for the property. In this example, the indexer is given
        // a different name by using the IndexerNameAttribute attribute.
        PropertyInfo piIndexedInstance =
            typeof(Example).GetProperty("IndexedInstanceProperty");
        piIndexedInstance.SetValue(
            exam,
            "New value for string number 17",
            new object[] { (int) 17 });

        Console.WriteLine(
            "Final value of indexed instance property(17): '{0}'",
            exam[17]);
    }
}

/* This example produces the following output:

Initial value of class-level property: 41
Final value of class-level property: 76

Initial value of instance property: 42
Final value of instance property: 37

Initial value of indexed instance property(17): 'String number 17'
Final value of indexed instance property(17): 'New value for string number 17'
 */

Imports System.Reflection
Imports System.Collections.Generic

Class Example

    Private Shared _sharedProperty As Integer = 41
    Public Shared Property SharedProperty As Integer
        Get 
            Return _sharedProperty
        End Get
        Set
            _sharedProperty = Value
        End Set
    End Property

    Private _instanceProperty As Integer = 42
    Public Property InstanceProperty As Integer
        Get 
            Return _instanceProperty
        End Get
        Set
            _instanceProperty = Value
        End Set
    End Property

    Private _indexedInstanceProperty As New Dictionary(Of Integer, String)
    Default Public Property IndexedInstanceProperty(ByVal key As Integer) As String
        Get 
            Dim returnValue As String = Nothing
            If _indexedInstanceProperty.TryGetValue(key, returnValue) Then
                Return returnValue
            Else
                Return Nothing
            End If
        End Get
        Set
            If Value Is Nothing Then
                Throw New ArgumentNullException( _
                    "IndexedInstanceProperty value can be an empty string, but it cannot be Nothing.")
            Else
                If _indexedInstanceProperty.ContainsKey(key) Then
                    _indexedInstanceProperty(key) = Value
                Else
                    _indexedInstanceProperty.Add(key, Value)
                End If
            End If
        End Set
    End Property


    Shared Sub Main()

        Console.WriteLine("Initial value of class-level property: {0}", _
            Example.SharedProperty)

        Dim piShared As PropertyInfo = _
            GetType(Example).GetProperty("SharedProperty")
        piShared.SetValue( _
            Nothing, _
            76, _
            Nothing)
                 
        Console.WriteLine("Final value of class-level property: {0}", _
            Example.SharedProperty)


        Dim exam As New Example

        Console.WriteLine(vbCrLf & _
            "Initial value of instance property: {0}", _
            exam.InstanceProperty)

        Dim piInstance As PropertyInfo = _
            GetType(Example).GetProperty("InstanceProperty")
        piInstance.SetValue( _
            exam, _
            37, _
            Nothing)
                 
        Console.WriteLine("Final value of instance property: {0}", _
            exam.InstanceProperty)


        exam(17) = "String number 17"
        exam(46) = "String number 46"
        ' In Visual Basic, a default indexed property can also be referred
        ' to by name.
        exam.IndexedInstanceProperty(9) = "String number 9"

        Console.WriteLine(vbCrLf & _
            "Initial value of indexed instance property(17): '{0}'", _
            exam(17))

        Dim piIndexedInstance As PropertyInfo = _
            GetType(Example).GetProperty("IndexedInstanceProperty")
        piIndexedInstance.SetValue( _
            exam, _
            "New value for string number 17", _
            New Object() { CType(17, Integer) })
                 
        Console.WriteLine("Final value of indexed instance property(17): '{0}'", _
            exam(17))
        
    End Sub
End Class

' This example produces the following output:
'
'Initial value of class-level property: 41
'Final value of class-level property: 76
'
'Initial value of instance property: 42
'Final value of instance property: 37
'
'Initial value of indexed instance property(17): 'String number 17'
'Final value of indexed instance property(17): 'New value for string number 17'

Poznámky

Pokud je tento PropertyInfo objekt typ hodnoty a value je null, bude vlastnost nastavena na výchozí hodnotu pro tento typ.

Chcete-li zjistit, zda je vlastnost indexována, použijte metodu GetIndexParameters . Pokud má výsledná matice 0 (nula) prvků, vlastnost není indexována.

Jedná se o pohodlnou metodu, která volá implementaci modulu runtime abstraktní SetValue(Object, Object, BindingFlags, Binder, Object[], CultureInfo) metody a určuje BindingFlags.Default pro BindingFlags parametr , nullBindera null pro CultureInfo.

Chcete-li použít metodu SetValue , nejprve získejte Type objekt, který představuje třídu. Z nástroje Typezískejte .PropertyInfo V souboru PropertyInfopoužijte metodu SetValue .

Poznámka

Počínaje rozhraním .NET Framework 2.0 lze tuto metodu použít pro přístup k neveřejným členům, pokud byl volajícímu udělen ReflectionPermissionReflectionPermissionFlag.RestrictedMemberAccess příznak a pokud je sada udělení neveřejných členů omezena na sadu udělení volajícího nebo její podmnožinu. (Viz Aspekty zabezpečení pro reflexi.) Pokud chcete tuto funkci používat, měla by vaše aplikace cílit na rozhraní .NET Framework 3.5 nebo novější.

Platí pro

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

Zdroj:
PropertyInfo.cs
Zdroj:
PropertyInfo.cs
Zdroj:
PropertyInfo.cs

Při přepsání v odvozené třídě nastaví hodnotu vlastnosti pro zadaný objekt, který má zadanou vazbu, index a informace specifické pro jazykovou verzi.

public:
 abstract void SetValue(System::Object ^ obj, System::Object ^ value, System::Reflection::BindingFlags invokeAttr, System::Reflection::Binder ^ binder, cli::array <System::Object ^> ^ index, System::Globalization::CultureInfo ^ culture);
public abstract void SetValue (object? obj, object? value, System.Reflection.BindingFlags invokeAttr, System.Reflection.Binder? binder, object?[]? index, System.Globalization.CultureInfo? culture);
public abstract void SetValue (object obj, object value, System.Reflection.BindingFlags invokeAttr, System.Reflection.Binder binder, object[] index, System.Globalization.CultureInfo culture);
abstract member SetValue : obj * obj * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo -> unit
Public MustOverride Sub SetValue (obj As Object, value As Object, invokeAttr As BindingFlags, binder As Binder, index As Object(), culture As CultureInfo)

Parametry

obj
Object

Objekt, jehož hodnota vlastnosti bude nastavena.

value
Object

Hodnota nové vlastnosti

invokeAttr
BindingFlags

Bitové kombinace následujících členů výčtu, které určují atribut vyvolání: InvokeMethod, CreateInstance, Static, GetField, SetField, , GetPropertynebo SetProperty. Musíte zadat vhodný atribut vyvolání. Pokud chcete například vyvolat statický člen, nastavte Static příznak.

binder
Binder

Objekt, který umožňuje vazbu, vynucování typů argumentů, vyvolání členů a načtení MemberInfo objektů prostřednictvím reflexe. Pokud binder je null, použije se výchozí pořadač.

index
Object[]

Volitelné hodnoty indexů pro indexované vlastnosti. Tato hodnota by měla být null pro neindexované vlastnosti.

culture
CultureInfo

Jazyková verze, pro kterou má být prostředek lokalizován. Pokud prostředek není lokalizován pro tuto jazykovou verzi, Parent bude vlastnost volána postupně při hledání shody. Pokud je nulltato hodnota , informace specifické pro jazykovou verzi jsou získány CurrentUICulture z vlastnosti .

Implementuje

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

Výjimky

ArgumentException

Pole index neobsahuje požadovaný typ argumentů.

-nebo-

Příslušenství vlastnosti set se nenašlo.

-nebo-

value nelze převést na typ PropertyType.

TargetException

Objekt neodpovídá cílovému typu nebo vlastnost je vlastnost instance, ale obj je null.

TargetParameterCountException

Počet parametrů v index souboru neodpovídá počtu parametrů, které indexovaná vlastnost přijímá.

MethodAccessException

Došlo k neoprávněnému pokusu o přístup k privátní nebo chráněné metodě uvnitř třídy.

TargetInvocationException

Při nastavování hodnoty vlastnosti došlo k chybě. Například hodnota indexu zadaná pro indexovanou vlastnost je mimo rozsah. Vlastnost InnerException označuje důvod chyby.

Poznámky

Pokud je tento PropertyInfo objekt hodnotový typ a value je null, vlastnost se nastaví na výchozí hodnotu pro tento typ.

Chcete-li zjistit, zda je vlastnost indexována, použijte metodu GetIndexParameters . Pokud má výsledné pole 0 (nula) prvků, vlastnost se neindexuje.

Omezení přístupu jsou ignorována pro plně důvěryhodný kód. To znamená, že k soukromým konstruktorům, metodám, polím a vlastnostem je možné přistupovat a volat prostřednictvím reflexe vždy, když je kód plně důvěryhodný.

Pokud chcete použít metodu SetValue , nejprve získejte třídu Type. V souboru Typezískejte PropertyInfo. V souboru PropertyInfopoužijte metodu SetValue .

Poznámka

Počínaje rozhraním .NET Framework 2.0 lze tuto metodu použít pro přístup k neveřejným členům, pokud volajícímu byl udělen ReflectionPermissionReflectionPermissionFlag.RestrictedMemberAccess příznak a pokud je sada udělení neveřejných členů omezena na sadu udělení volajícího nebo její podmnožinu. (Viz Aspekty zabezpečení pro reflexi.) Pokud chcete tuto funkci používat, měla by vaše aplikace cílit na rozhraní .NET Framework 3.5 nebo novější.

Platí pro