PropertyInfo.SetValue Método

  • Referência

Definição

Namespace:
System.Reflection
Assembly:
System.Reflection.dll
Assembly:
System.Runtime.dll
Assembly:
netstandard.dll
Assembly:
mscorlib.dll

Define o valor da propriedade de um objeto especificado.

Sobrecargas

SetValue(Object, Object)

Define o valor da propriedade de um objeto especificado.
SetValue(Object, Object, Object[])

Define o valor da propriedade de um objeto especificado com valores de índice opcionais para as propriedades de índice.
SetValue(Object, Object, BindingFlags, Binder, Object[], CultureInfo)

Quando é substituído em uma classe derivada, define o valor da propriedade de um objeto especificado que tem as informações específicas da cultura, índice e associação especificadas.

SetValue(Object, Object)

Define o valor da propriedade de um objeto especificado.

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)

Parâmetros

obj
Object

O objeto cujo valor da propriedade será definido.

value
Object

O novo valor da propriedade.

Exceções

ArgumentException

O acessador set da propriedade não foi encontrado.

  • ou - Não é possível converter value para o tipo de PropertyType.
TargetException

O tipo de obj não corresponde ao tipo de destino ou uma propriedade é uma propriedade de instância, mas obj é null.

observação: no .net para aplicativos da Windows store ou a biblioteca de classes portátil, pegue Exception em vez disso.

MethodAccessException

Houve uma tentativa inválida de acessar um método privado ou protegido em uma classe.

observação: no .net para aplicativos da Windows store ou a biblioteca de classes portátil, capture a exceção da classe base, MemberAccessException em vez disso.

TargetInvocationException

Ocorreu um erro ao definir o valor da propriedade. A propriedade InnerException indica o motivo do erro.

Exemplos

O exemplo a seguir declara uma classe chamada Example com uma ( em static Shared Visual Basic) e uma propriedade de instância. O exemplo usa o SetValue(Object, Object) método para alterar os valores de propriedade originais e exibe os valores originais e finais.

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

Comentários

A SetValue(Object, Object) sobrecarga define o valor de uma propriedade não indexada. Para determinar se uma propriedade é indexada, chame o GetIndexParameters método . Se a matriz resultante tiver 0 (zero) elementos, a propriedade não será indexada. Para definir o valor de uma propriedade indexada, chame a SetValue(Object, Object, Object[]) sobrecarga .

Se o tipo de propriedade desse objeto for um tipo de valor e for , a propriedade será definida como o PropertyInfo valor padrão para esse value null tipo.

Esse é um método de conveniência que chama a implementação de runtime do método abstrato, especificando para o parâmetro , para SetValue(Object, Object, BindingFlags, Binder, Object[], CultureInfo) , para e BindingFlags.Default para BindingFlags null Binder null Object[] null CultureInfo .

Para usar o SetValue método , primeiro obter um objeto que representa a classe Type . No Type , obter o PropertyInfo objeto . No objeto PropertyInfo , chame o método SetValue .

Observação

A partir do .NET Framework 2.0 Service Pack 1, esse método poderá ser usado para acessar membros não públicos se o chamador tiver sido concedido com o sinalizador e se o conjunto de concessões dos membros não públicos for restrito ao conjunto de concessões do chamador ou a um ReflectionPermission ReflectionPermissionFlag.RestrictedMemberAccess subconjunto. (Consulte Considerações sobre segurança para reflexão.)

Para usar essa funcionalidade, seu aplicativo deve ter como destino o .NET Framework 3.5 ou posterior.

Aplica-se a

SetValue(Object, Object, Object[])

Define o valor da propriedade de um objeto especificado com valores de índice opcionais para as propriedades de índice.

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

Parâmetros

obj
Object

O objeto cujo valor da propriedade será definido.

value
Object

O novo valor da propriedade.

index
Object[]

Valores de índice opcionais para propriedades indexadas. Esse valor deve ser null para propriedades não indexadas.

Implementações

SetValue(Object, Object, Object[])

Exceções

ArgumentException

A matriz index não contém o tipo de argumentos necessários.

  • ou - O acessador set da propriedade não foi encontrado.

  • ou - Não é possível converter value para o tipo de PropertyType.

TargetException

O objeto não corresponde ao tipo de destino ou uma propriedade é uma propriedade de instância, mas obj é null.

observação: no .net para aplicativos da Windows store ou a biblioteca de classes portátil, pegue Exception em vez disso.

TargetParameterCountException

O número de parâmetros em index não corresponde ao número de parâmetros usados pela propriedade indexada.

MethodAccessException

Houve uma tentativa inválida de acessar um método privado ou protegido em uma classe.

observação: no .net para aplicativos da Windows store ou a biblioteca de classes portátil, capture a exceção da classe base, MemberAccessException em vez disso.

TargetInvocationException

Ocorreu um erro ao definir o valor da propriedade. Por exemplo, um valor de índice especificado para uma propriedade indexada está fora do intervalo. A propriedade InnerException indica o motivo do erro.

Exemplos

O exemplo a seguir define uma classe denominada TestClass que tem uma propriedade de leitura/gravação chamada Caption . Ele exibe o valor padrão da Caption propriedade, chama o SetValue método para alterar o valor da propriedade e exibe o resultado.

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.

Observe que, como a Caption propriedade não é uma matriz de parâmetros, o index argumento é null .

o exemplo a seguir declara uma classe chamada Example com três propriedades: uma static propriedade ( Shared em Visual Basic), uma propriedade de instância e uma propriedade de instância indexada. O exemplo usa o SetValue método para alterar os valores padrão das propriedades e exibe os valores originais e finais.

O nome usado para pesquisar uma propriedade de instância indexada com reflexão é diferente dependendo do idioma e dos atributos aplicados à propriedade.

  • em Visual Basic, o nome da propriedade é sempre usado para pesquisar a propriedade com reflexão. Você pode usar a Default palavra-chave para tornar a propriedade uma propriedade indexada padrão; nesse caso, você pode omitir o nome ao acessar a propriedade, como neste exemplo. Você também pode usar o nome da propriedade.

  • No C#, a propriedade de instância indexada é uma propriedade padrão chamada de indexador e o nome nunca é usado ao acessar a propriedade no código. Por padrão, o nome da propriedade é Item , e você deve usar esse nome ao pesquisar a propriedade com reflexão. Você pode usar o IndexerNameAttribute atributo para dar um nome diferente ao indexador. Neste exemplo, o nome é IndexedInstanceProperty.

  • Em C++, o default especificador pode ser usado para tornar uma propriedade indexada uma propriedade indexada padrão (indexador de classe). Nesse caso, o nome da propriedade por padrão é Item , e você deve usar esse nome ao pesquisar a propriedade com reflexão, como neste exemplo. Você pode usar o IndexerNameAttribute atributo para dar ao indexador de classe um nome diferente em reflexão, mas não pode usar esse nome para acessar a propriedade no código. Uma propriedade indexada que não é um indexador de classe é acessada usando seu nome, tanto no código quanto na reflexão.

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'

Comentários

Se esse PropertyInfo objeto for um tipo de valor e value for null , a propriedade será definida como o valor padrão para esse tipo.

Para determinar se uma propriedade é indexada, use o GetIndexParameters método. Se a matriz resultante tiver 0 (zero) elementos, a propriedade não será indexada.

Esse é um método de conveniência que chama a implementação de tempo de execução do SetValue(Object, Object, BindingFlags, Binder, Object[], CultureInfo) método abstract, especificando BindingFlags.Default para o BindingFlags parâmetro, null para Binder e null para CultureInfo .

Para usar o SetValue método, primeiro obtenha um Type objeto que represente a classe. No Type , obtenha o PropertyInfo . No PropertyInfo , use o SetValue método.

Observação

a partir do .NET Framework 2,0 Service Pack 1, esse método poderá ser usado para acessar membros não públicos se o chamador tiver sido concedido ReflectionPermission com o ReflectionPermissionFlag.RestrictedMemberAccess sinalizador e se o grant set dos membros não públicos for restrito ao conjunto de concessão do chamador ou a um subconjunto dele. (Consulte considerações de segurança para reflexão.)

para usar essa funcionalidade, seu aplicativo deve ter como destino o .NET Framework 3,5 ou posterior.

Aplica-se a

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

Quando é substituído em uma classe derivada, define o valor da propriedade de um objeto especificado que tem as informações específicas da cultura, índice e associação especificadas.

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)

Parâmetros

obj
Object

O objeto cujo valor da propriedade será definido.

value
Object

O novo valor da propriedade.

invokeAttr
BindingFlags

Uma combinação bit a bit dos seguintes membros de enumeração que especifica o atributo de invocação: InvokeMethod, CreateInstance, Static, GetField, SetField, GetProperty ou SetProperty. É necessário especificar um atributo de invocação adequado. Por exemplo, para invocar um membro estático, defina o sinalizador Static.

binder
Binder

Um objeto que permite a associação, a coerção de tipos de argumento, a invocação de membros e a recuperação de objetos MemberInfo por meio da reflexão. Caso binder seja null, o associador padrão é usado.

index
Object[]

Valores de índice opcionais para propriedades indexadas. Esse valor deve ser null para propriedades não indexadas.

culture
CultureInfo

A cultura para a qual o recurso deve ser localizado. Se o recurso não estiver localizado para essa cultura, a propriedade Parent será chamada sucessivamente em busca de uma correspondência. Se esse valor for null, as informações específicas da cultura serão obtidas da propriedade CurrentUICulture.

Implementações

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

Exceções

ArgumentException

A matriz index não contém o tipo de argumentos necessários.

  • ou - O acessador set da propriedade não foi encontrado.

  • ou - Não é possível converter value para o tipo de PropertyType.

TargetException

O objeto não corresponde ao tipo de destino ou uma propriedade é uma propriedade de instância, mas obj é null.

TargetParameterCountException

O número de parâmetros em index não corresponde ao número de parâmetros usados pela propriedade indexada.

MethodAccessException

Houve uma tentativa inválida de acessar um método privado ou protegido em uma classe.

TargetInvocationException

Ocorreu um erro ao definir o valor da propriedade. Por exemplo, um valor de índice especificado para uma propriedade indexada está fora do intervalo. A propriedade InnerException indica o motivo do erro.

Comentários

Se esse PropertyInfo objeto for um tipo de valor e value for null , a propriedade será definida como o valor padrão para esse tipo.

Para determinar se uma propriedade é indexada, use o GetIndexParameters método. Se a matriz resultante tiver 0 (zero) elementos, a propriedade não será indexada.

As restrições de acesso são ignoradas para código totalmente confiável. Ou seja, construtores particulares, métodos, campos e propriedades podem ser acessados e invocados por meio de reflexão sempre que o código é totalmente confiável.

Para usar o SetValue método, primeiro obtenha a classe Type . No Type , obtenha o PropertyInfo . No PropertyInfo , use o SetValue método.

Observação

a partir do .NET Framework 2,0 Service Pack 1, esse método poderá ser usado para acessar membros não públicos se o chamador tiver sido concedido ReflectionPermission com o ReflectionPermissionFlag.RestrictedMemberAccess sinalizador e se o grant set dos membros não públicos for restrito ao conjunto de concessão do chamador ou a um subconjunto dele. (Consulte considerações de segurança para reflexão.)

para usar essa funcionalidade, seu aplicativo deve ter como destino o .NET Framework 3,5 ou posterior.

Aplica-se a