PropertyInfo.SetValue PropertyInfo.SetValue PropertyInfo.SetValue PropertyInfo.SetValue Method

Definición

Establece el valor de propiedad para un objeto especificado.Sets the property value for a specified object.

Sobrecargas

SetValue(Object, Object) SetValue(Object, Object) SetValue(Object, Object) SetValue(Object, Object)

Establece el valor de propiedad de un objeto especificado.Sets the property value of a specified object.

SetValue(Object, Object, Object[]) SetValue(Object, Object, Object[]) SetValue(Object, Object, Object[]) SetValue(Object, Object, Object[])

Establece el valor de propiedad de un objeto especificado con valores de índice opcionales para las propiedades del índice.Sets the property value of a specified object with optional index values for index properties.

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

Cuando se reemplaza en una clase derivada, establece el valor de propiedad para un objeto especificado que tiene el enlace, el índice y la información específica de la referencia cultural especificados.When overridden in a derived class, sets the property value for a specified object that has the specified binding, index, and culture-specific information.

SetValue(Object, Object) SetValue(Object, Object) SetValue(Object, Object) SetValue(Object, Object)

Establece el valor de propiedad de un objeto especificado.Sets the property value of a specified object.

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)

Parámetros

obj
Object Object Object Object

Objeto cuyo valor de propiedad se va a establecer.The object whose property value will be set.

value
Object Object Object Object

Nuevo valor de propiedad.The new property value.

Excepciones

No se encuentra el descriptor de acceso set de la propiedad.The property's set accessor is not found.

O bien-or- value no se puede convertir al tipo de PropertyType.value cannot be converted to the type of PropertyType.

En .NET para aplicaciones de la Tienda Windows o la Biblioteca de clases portable, capture Exception en su lugar.In the .NET for Windows Store apps or the Portable Class Library, catch Exception instead.

El tipo de obj no coincide con el tipo de destino o una propiedad es una propiedad de instancia, pero obj es null.The type of obj does not match the target type, or a property is an instance property but obj is null.

En .NET para aplicaciones de la Tienda Windows o la Biblioteca de clases portable, capture en su lugar la excepción de clase base, MemberAccessException.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, MemberAccessException, instead.

Hubo un intento no válido de obtener acceso a un método privado o protegido dentro de una clase.There was an illegal attempt to access a private or protected method inside a class.

Error al establecer el valor de la propiedad.An error occurred while setting the property value. La propiedad InnerException indica el motivo del error.The InnerException property indicates the reason for the error.

Ejemplos

En el ejemplo siguiente se declara una clase denominada Example con uno static (Shared en Visual Basic) y la propiedad de una instancia.The following example declares a class named Example with one static (Shared in Visual Basic) and one instance property. El ejemplo se usa el SetValue(Object, Object) método para cambiar la propiedad original y muestra los valores originales y finales.The example uses the SetValue(Object, Object) method to change the original property values and displays the original and final values.

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

Comentarios

El SetValue(Object, Object) sobrecarga establece el valor de una propiedad no indizada.The SetValue(Object, Object) overload sets the value of a non-indexed property. Para determinar si una propiedad está indizada, llame a la GetIndexParameters método.To determine whether a property is indexed, call the GetIndexParameters method. Si la matriz resultante tiene 0 (cero) elementos, la propiedad no está indizado.If the resulting array has 0 (zero) elements, the property is not indexed. Para establecer el valor de una propiedad indizada, llame a la SetValue(Object, Object, Object[]) de sobrecarga.To set the value of an indexed property, call the SetValue(Object, Object, Object[]) overload.

Si la propiedad tipo de este PropertyInfo objeto es un tipo de valor y value es null, la propiedad se establecerá en el valor predeterminado para ese tipo.If the property type of this PropertyInfo object is a value type and value is null, the property will be set to the default value for that type.

Se trata de un método de conveniencia que llama a la implementación en tiempo de ejecución del resumen SetValue(Object, Object, BindingFlags, Binder, Object[], CultureInfo) método, especifica BindingFlags.Default para el BindingFlags parámetro, null para Binder, null para Object[]y null para CultureInfo.This is a convenience method that calls the runtime implementation of the abstract SetValue(Object, Object, BindingFlags, Binder, Object[], CultureInfo) method, specifying BindingFlags.Default for the BindingFlags parameter, null for Binder, null for Object[], and null for CultureInfo.

Para usar el SetValue método, primero obtenga una Type objeto que representa la clase.To use the SetValue method, first get a Type object that represents the class. Desde el Type, obtener el PropertyInfo objeto.From the Type, get the PropertyInfo object. Desde el PropertyInfo de objeto, llame a la SetValue método.From the PropertyInfo object, call the SetValue method.

Nota

A partir de la .NET Framework 2.0 Service Pack 1.NET Framework 2.0 Service Pack 1, este método puede utilizarse para tener acceso a miembros no públicos, si el llamador tiene concedidos ReflectionPermission con el ReflectionPermissionFlag.RestrictedMemberAccess marca y si el conjunto de permisos de los miembros no públicos se restringe al llamador conceder el conjunto o un subconjunto en ella.Starting with the .NET Framework 2.0 Service Pack 1.NET Framework 2.0 Service Pack 1, this method can be used to access non-public members if the caller has been granted ReflectionPermission with the ReflectionPermissionFlag.RestrictedMemberAccess flag and if the grant set of the non-public members is restricted to the caller's grant set, or a subset thereof. (Consulte consideraciones de seguridad para la reflexión.)(See Security Considerations for Reflection.)

Para utilizar esta funcionalidad, la aplicación debe utilizar .NET Framework 3,5.NET Framework 3.5 o posterior como destino.To use this functionality, your application should target the .NET Framework 3,5.NET Framework 3.5 or later.

Seguridad

ReflectionPermission
Cuando se invoca en tiempo de ejecución a través de mecanismos como InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]).when invoked late-bound through mechanisms such as InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]). Enumeración asociada: MemberAccess.Associated enumeration: MemberAccess.

SetValue(Object, Object, Object[]) SetValue(Object, Object, Object[]) SetValue(Object, Object, Object[]) SetValue(Object, Object, Object[])

Establece el valor de propiedad de un objeto especificado con valores de índice opcionales para las propiedades del índice.Sets the property value of a specified object with optional index values for index properties.

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

Objeto cuyo valor de propiedad se va a establecer.The object whose property value will be set.

value
Object Object Object Object

Nuevo valor de propiedad.The new property value.

index
Object[]

Valores de índice opcionales para propiedades indizadas.Optional index values for indexed properties. Este valor debe ser null para propiedades no indizadas.This value should be null for non-indexed properties.

Implementaciones

Excepciones

La matriz index no contiene el tipo de argumentos necesario.The index array does not contain the type of arguments needed.

O bien-or- No se encuentra el descriptor de acceso set de la propiedad.The property's set accessor is not found.

O bien-or- value no se puede convertir al tipo de PropertyType.value cannot be converted to the type of PropertyType.

En .NET para aplicaciones de la Tienda Windows o la Biblioteca de clases portable, capture Exception en su lugar.In the .NET for Windows Store apps or the Portable Class Library, catch Exception instead.

El objeto no coincide con el tipo de destino o una propiedad es una propiedad de instancia pero obj es null.The object does not match the target type, or a property is an instance property but obj is null.

El número de parámetros de index no coincide con el número de parámetros que toma la propiedad indexada.The number of parameters in index does not match the number of parameters the indexed property takes.

En .NET para aplicaciones de la Tienda Windows o la Biblioteca de clases portable, capture en su lugar la excepción de clase base, MemberAccessException.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, MemberAccessException, instead.

Hubo un intento no válido de obtener acceso a un método privado o protegido dentro de una clase.There was an illegal attempt to access a private or protected method inside a class.

Error al establecer el valor de la propiedad.An error occurred while setting the property value. Por ejemplo, un valor de índice especificado para una propiedad indizada está fuera del intervalo.For example, an index value specified for an indexed property is out of range. La propiedad InnerException indica el motivo del error.The InnerException property indicates the reason for the error.

Ejemplos

En el ejemplo siguiente se define una clase denominada TestClass que tiene una propiedad de lectura y escritura denominada Caption.The following example defines a class named TestClass that has a read-write property named Caption. Muestra el valor predeterminado de la Caption propiedad, llama el SetValue método para cambiar el valor de propiedad y muestra el resultado.It displays the default value of the Caption property, calls the SetValue method to change the property value, and displays the result.

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
Imports System.Reflection
Imports Microsoft.VisualBasic

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

Tenga en cuenta que, dado el Caption propiedad no es una matriz de parámetros, el index argumento es null.Note that, because the Caption property is not a parameter array, the index argument is null.

En el ejemplo siguiente se declara una clase denominada Example con tres propiedades: una static propiedad (Shared en Visual Basic), una propiedad de instancia y una propiedad de instancia indizada.The following example declares a class named Example with three properties: a static property (Shared in Visual Basic), an instance property, and an indexed instance property. El ejemplo se usa el SetValue método para cambiar los valores predeterminados de las propiedades y muestra los valores originales y finales.The example uses the SetValue method to change the default values of the properties and displays the original and final values.

El nombre que se usa para buscar una propiedad de instancia indizada con reflexión es diferente según el idioma y de los atributos aplicados a la propiedad.The name that is used to search for an indexed instance property with reflection is different depending on the language and on attributes applied to the property.

  • En Visual Basic, el nombre de propiedad siempre se utiliza para buscar la propiedad con reflexión.In Visual Basic, the property name is always used to search for the property with reflection. Puede usar el Default propiedad de la palabra clave para convertir un valor predeterminado de la propiedad indizada, en cuyo caso puede omitir el nombre al obtener acceso a la propiedad, como en este ejemplo.You can use the Default keyword to make the property a default indexed property, in which case you can omit the name when accessing the property, as in this example. También puede usar el nombre de propiedad.You can also use the property name.

  • En C#, la propiedad de instancia indizada es una propiedad predeterminada denominada indizador y el nombre nunca se usa al obtener acceso a la propiedad en el código.In C#, the indexed instance property is a default property called an indexer, and the name is never used when accessing the property in code. De forma predeterminada, el nombre de la propiedad es Item, y debe usar ese nombre cuando busque la propiedad con reflexión.By default, the name of the property is Item, and you must use that name when you search for the property with reflection. Puede usar el IndexerNameAttribute atributo para asignar un nombre diferente de indizador.You can use the IndexerNameAttribute attribute to give the indexer a different name. En este ejemplo, el nombre es IndexedInstanceProperty.In this example, the name is IndexedInstanceProperty.

  • En C++, el default especificador puede usarse para convertir un valor predeterminado de una propiedad indizada (indizador de clase) de la propiedad indizada.In C++, the default specifier can be used to make an indexed property a default indexed property (class indexer). En ese caso, el nombre de la propiedad predeterminada es Item, y debe usar ese nombre al realizar una búsqueda para la propiedad con reflexión, como en este ejemplo.In that case, the name of the property by default is Item, and you must use that name when you search for the property with reflection, as in this example. Puede usar el IndexerNameAttribute atributo para asignar un nombre diferente del indizador de clase en la reflexión, pero no se puede usar ese nombre para tener acceso a la propiedad en el código.You can use the IndexerNameAttribute attribute to give the class indexer a different name in reflection, but you cannot use that name to access the property in code. Se tiene acceso a una propiedad indizada que no es un indizador de clase utilizando su nombre tanto en el código en la reflexión.An indexed property that is not a class indexer is accessed using its name, both in code and in reflection.

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'

Comentarios

Si este PropertyInfo objeto es un tipo de valor y value es null, la propiedad se establecerá en el valor predeterminado para ese tipo.If this PropertyInfo object is a value type and value is null, then the property will be set to the default value for that type.

Para determinar si una propiedad está indizada, use el GetIndexParameters método.To determine whether a property is indexed, use the GetIndexParameters method. Si la matriz resultante tiene 0 (cero) elementos, la propiedad no está indizado.If the resulting array has 0 (zero) elements, the property is not indexed.

Se trata de un método de conveniencia que llama a la implementación en tiempo de ejecución del resumen SetValue(Object, Object, BindingFlags, Binder, Object[], CultureInfo) método, especifica BindingFlags.Default para el BindingFlags parámetro, null para Binder, y null para CultureInfo.This is a convenience method that calls the runtime implementation of the abstract SetValue(Object, Object, BindingFlags, Binder, Object[], CultureInfo) method, specifying BindingFlags.Default for the BindingFlags parameter, null for Binder, and null for CultureInfo.

Para usar el SetValue método, primero obtenga una Type objeto que representa la clase.To use the SetValue method, first get a Type object that represents the class. Desde el Type, obtener el PropertyInfo.From the Type, get the PropertyInfo. Desde el PropertyInfo, utilice el SetValue método.From the PropertyInfo, use the SetValue method.

Nota

A partir de la .NET Framework 2.0 Service Pack 1.NET Framework 2.0 Service Pack 1, este método puede utilizarse para tener acceso a miembros no públicos, si el llamador tiene concedidos ReflectionPermission con el ReflectionPermissionFlag.RestrictedMemberAccess marca y si el conjunto de permisos de los miembros no públicos se restringe al llamador conceder el conjunto o un subconjunto en ella.Starting with the .NET Framework 2.0 Service Pack 1.NET Framework 2.0 Service Pack 1, this method can be used to access non-public members if the caller has been granted ReflectionPermission with the ReflectionPermissionFlag.RestrictedMemberAccess flag and if the grant set of the non-public members is restricted to the caller's grant set, or a subset thereof. (Consulte consideraciones de seguridad para la reflexión.)(See Security Considerations for Reflection.)

Para utilizar esta funcionalidad, la aplicación debe utilizar .NET Framework 3,5.NET Framework 3.5 o posterior como destino.To use this functionality, your application should target the .NET Framework 3,5.NET Framework 3.5 or later.

Seguridad

ReflectionPermission
Cuando se invoca en tiempo de ejecución a través de mecanismos como InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]).when invoked late-bound through mechanisms such as InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]). Enumeración asociada: MemberAccess.Associated enumeration: MemberAccess.

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

Cuando se reemplaza en una clase derivada, establece el valor de propiedad para un objeto especificado que tiene el enlace, el índice y la información específica de la referencia cultural especificados.When overridden in a derived class, sets the property value for a specified object that has the specified binding, index, and culture-specific information.

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);
abstract member SetValue : obj * obj * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo -> unit

Parámetros

obj
Object Object Object Object

Objeto cuyo valor de propiedad se va a establecer.The object whose property value will be set.

value
Object Object Object Object

Nuevo valor de propiedad.The new property value.

invokeAttr
BindingFlags BindingFlags BindingFlags BindingFlags

Una combinación bit a bit de los miembros de enumeración siguientes que especifican el atributo de invocación: InvokeMethod, CreateInstance, Static, GetField, SetField, GetProperty o SetProperty.A bitwise combination of the following enumeration members that specify the invocation attribute: InvokeMethod, CreateInstance, Static, GetField, SetField, GetProperty, or SetProperty. Debe especificarse un atributo de invocación apropiado.You must specify a suitable invocation attribute. Por ejemplo, para llamar a un miembro estático, establezca la marca Static.For example, to invoke a static member, set the Static flag.

binder
Binder Binder Binder Binder

Objeto que permite el enlace, la conversión de tipos de argumentos, la llamada de miembros y la recuperación de objetos MemberInfo mediante reflexión.An object that enables the binding, coercion of argument types, invocation of members, and retrieval of MemberInfo objects through reflection. Si binder es null, se usa el enlazador predeterminado.If binder is null, the default binder is used.

index
Object[]

Valores de índice opcionales para propiedades indizadas.Optional index values for indexed properties. Este valor debe ser null para propiedades no indizadas.This value should be null for non-indexed properties.

culture
CultureInfo CultureInfo CultureInfo CultureInfo

Referencia cultural a la que se va a adaptar el recurso.The culture for which the resource is to be localized. Si el recurso no se encuentra el recurso correspondiente a esta referencia cultural, se llamará sucesivamente a Parent para buscar una coincidencia.If the resource is not localized for this culture, the Parent property will be called successively in search of a match. Si este valor es null, la información específica de la referencia cultural se obtiene de la propiedad CurrentUICulture.If this value is null, the culture-specific information is obtained from the CurrentUICulture property.

Implementaciones

Excepciones

La matriz index no contiene el tipo de argumentos necesario.The index array does not contain the type of arguments needed.

O bien-or- No se encuentra el descriptor de acceso set de la propiedad.The property's set accessor is not found.

O bien-or- value no se puede convertir al tipo de PropertyType.value cannot be converted to the type of PropertyType.

El objeto no coincide con el tipo de destino o una propiedad es una propiedad de instancia, pero obj es null.The object does not match the target type, or a property is an instance property but obj is null.

El número de parámetros de index no coincide con el número de parámetros que toma la propiedad indexada.The number of parameters in index does not match the number of parameters the indexed property takes.

Hubo un intento no válido de obtener acceso a un método privado o protegido dentro de una clase.There was an illegal attempt to access a private or protected method inside a class.

Error al establecer el valor de la propiedad.An error occurred while setting the property value. Por ejemplo, un valor de índice especificado para una propiedad indizada está fuera del intervalo.For example, an index value specified for an indexed property is out of range. La propiedad InnerException indica el motivo del error.The InnerException property indicates the reason for the error.

Comentarios

Si este PropertyInfo objeto es un tipo de valor y value es null, la propiedad se establecerá en el valor predeterminado para ese tipo.If this PropertyInfo object is a value type and value is null, then the property will be set to the default value for that type.

Para determinar si una propiedad está indizada, use el GetIndexParameters método.To determine whether a property is indexed, use the GetIndexParameters method. Si la matriz resultante tiene 0 (cero) elementos, la propiedad no está indizado.If the resulting array has 0 (zero) elements, the property is not indexed.

Se omiten las restricciones de acceso para el código de plena confianza.Access restrictions are ignored for fully trusted code. Es decir, las propiedades, métodos, campos y constructores privados pueden tener acceso a e invoca a través de Reflection siempre que el código es de plena confianza.That is, private constructors, methods, fields, and properties can be accessed and invoked via Reflection whenever the code is fully trusted.

Para usar el SetValue método, obtenga primero la clase Type.To use the SetValue method, first get the class Type. Desde el Type, obtener el PropertyInfo.From the Type, get the PropertyInfo. Desde el PropertyInfo, utilice el SetValue método.From the PropertyInfo, use the SetValue method.

Nota

A partir de la .NET Framework 2.0 Service Pack 1.NET Framework 2.0 Service Pack 1, este método puede utilizarse para tener acceso a miembros no públicos, si el llamador tiene concedidos ReflectionPermission con el ReflectionPermissionFlag.RestrictedMemberAccess marca y si el conjunto de permisos de los miembros no públicos se restringe al llamador conceder el conjunto o un subconjunto en ella.Starting with the .NET Framework 2.0 Service Pack 1.NET Framework 2.0 Service Pack 1, this method can be used to access non-public members if the caller has been granted ReflectionPermission with the ReflectionPermissionFlag.RestrictedMemberAccess flag and if the grant set of the non-public members is restricted to the caller's grant set, or a subset thereof. (Consulte consideraciones de seguridad para la reflexión.)(See Security Considerations for Reflection.)

Para utilizar esta funcionalidad, la aplicación debe utilizar .NET Framework 3,5.NET Framework 3.5 o posterior como destino.To use this functionality, your application should target the .NET Framework 3,5.NET Framework 3.5 or later.

Seguridad

ReflectionPermission
Cuando se invoca en tiempo de ejecución a través de mecanismos como InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]).when invoked late-bound through mechanisms such as InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]). Enumeración asociada: MemberAccess.Associated enumeration: MemberAccess.

Se aplica a