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

정의

지정된 개체에 대한 속성 값을 설정합니다.Sets the property value for a specified object.

오버로드

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

지정된 개체의 속성 값을 설정합니다.Sets the property value of a specified object.

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

인덱스 속성에 대해 선택적인 인덱스 값이 있는 지정된 개체의 속성 값을 설정합니다.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)

파생된 클래스에서 재정의된 경우 지정된 바인딩, 인덱스 및 문화별 정보가 있는 지정된 개체에 대해 속성 값을 설정합니다.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)

지정된 개체의 속성 값을 설정합니다.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)

매개 변수

obj
Object Object Object Object

속성 값이 설정될 개체입니다.The object whose property value will be set.

value
Object Object Object Object

새 속성 값입니다.The new property value.

예외

속성의 set 접근자를 찾을 수 없습니다.The property's set accessor is not found.

또는-or- valuePropertyType의 형식으로 변환할 수 없습니다.value cannot be converted to the type of PropertyType.

Windows 스토어 앱용 .NET 또는 이식 가능한 클래스 라이브러리에서 대신 Exception을 catch합니다.In the .NET for Windows Store apps or the Portable Class Library, catch Exception instead.

obj의 형식이 대상 형식과 일치하지 않거나 속성이 인스턴스 속성이지만 objnull입니다.The type of obj does not match the target type, or a property is an instance property but obj is null.

Windows 스토어 앱용 .NET 또는 이식 가능한 클래스 라이브러리에서 대신 기본 클래스 예외 MemberAccessException을 catch합니다.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, MemberAccessException, instead.

클래스 내에서 개인 메서드 또는 보호된 메서드에 액세스하려는 잘못된 시도가 있었습니다.There was an illegal attempt to access a private or protected method inside a class.

속성 값을 설정할 때 오류가 발생했습니다.An error occurred while setting the property value. InnerException 속성은 오류가 발생한 원인을 나타냅니다.The InnerException property indicates the reason for the error.

예제

다음 예제에서는 라는 클래스를 선언 Example 하나를 사용 하 여 static (Shared Visual Basic의) 및 인스턴스 속성입니다.The following example declares a class named Example with one static (Shared in Visual Basic) and one instance property. 이 예제에서는 사용 된 SetValue(Object, Object) 원래 속성을 변경 하려면 메서드 값 및 원래 및 최종 값을 표시 합니다.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

설명

SetValue(Object, Object) 오버 로드는 인덱싱되지 않은 속성의 값을 설정 합니다.The SetValue(Object, Object) overload sets the value of a non-indexed property. 속성을 인덱싱 되었는지 여부를 확인, 호출 된 GetIndexParameters 메서드.To determine whether a property is indexed, call the GetIndexParameters method. 결과 배열에 0 (영) 요소가 속성은 인덱싱되지 않습니다.If the resulting array has 0 (zero) elements, the property is not indexed. 인덱싱된 속성의 값을 설정 하려면 호출을 SetValue(Object, Object, Object[]) 오버 로드 합니다.To set the value of an indexed property, call the SetValue(Object, Object, Object[]) overload.

이 속성을 입력 하는 경우 PropertyInfo 개체는 값 형식 및 valuenull, 속성을 해당 형식에 대 한 기본값으로 설정 됩니다.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.

추상 런타임 구현을 호출 하는 편리한 방법입니다 SetValue(Object, Object, BindingFlags, Binder, Object[], CultureInfo) 메서드를 지정 하 BindingFlags.Default 에 대 한 합니다 BindingFlags 매개 변수를 null 에 대 한 Bindernull 에 대 한 Object[], 및 null 에 대 한 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.

사용 하 여 SetValue 메서드를 먼저 가져온을 Type 클래스를 나타내는 개체입니다.To use the SetValue method, first get a Type object that represents the class. Type, 가져오기는 PropertyInfo 개체입니다.From the Type, get the PropertyInfo object. PropertyInfo 개체를 호출 합니다 SetValue 메서드.From the PropertyInfo object, call the SetValue method.

참고

부터 합니다 .NET Framework 2.0 서비스 팩 1.NET Framework 2.0 Service Pack 1,이 메서드를 사용 하 여 호출자에 게 부여 된 경우 public이 아닌 멤버에 액세스할 수 있습니다 ReflectionPermission 사용 하 여는 ReflectionPermissionFlag.RestrictedMemberAccess 플래그 및 public이 아닌 멤버의 권한 부여 집합 호출자 에게만 부여 된 집합 또는 하위 집합 그 합니다.Starting with the .NET Framework 2.0 서비스 팩 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. (참조 리플렉션의 보안 고려 사항.)(See Security Considerations for Reflection.)

이 기능을 사용하려면 애플리케이션이 .NET Framework 3.5.NET Framework 3.5 이상을 대상으로 해야 합니다.To use this functionality, your application should target the .NET Framework 3.5.NET Framework 3.5 or later.

보안

ReflectionPermission
호출 될 때 런타임에 바인딩된 메커니즘을 통해 같은 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[]). 연관된 열거형: MemberAccessAssociated enumeration: MemberAccess.

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

인덱스 속성에 대해 선택적인 인덱스 값이 있는 지정된 개체의 속성 값을 설정합니다.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())

매개 변수

obj
Object Object Object Object

속성 값이 설정될 개체입니다.The object whose property value will be set.

value
Object Object Object Object

새 속성 값입니다.The new property value.

index
Object[]

인덱싱된 속성에 대한 선택적 인덱스 값입니다.Optional index values for indexed properties. 인덱싱되지 않은 속성에 대해서는 이 값이 null이어야 합니다.This value should be null for non-indexed properties.

구현

예외

index 배열에 필요한 인수의 형식이 포함되어 있지 않습니다.The index array does not contain the type of arguments needed.

또는-or- 속성의 set 접근자를 찾을 수 없습니다.The property's set accessor is not found.

또는-or- valuePropertyType의 형식으로 변환할 수 없습니다.value cannot be converted to the type of PropertyType.

Windows 스토어 앱용 .NET 또는 이식 가능한 클래스 라이브러리에서 대신 Exception을 catch합니다.In the .NET for Windows Store apps or the Portable Class Library, catch Exception instead.

개체가 대상 형식과 일치하지 않거나 속성이 인스턴스 속성이지만 objnull입니다.The object does not match the target type, or a property is an instance property but obj is null.

index의 매개 변수 개수가 인덱싱된 속성 작업의 매개 변수 개수와 일치하지 않습니다.The number of parameters in index does not match the number of parameters the indexed property takes.

Windows 스토어 앱용 .NET 또는 이식 가능한 클래스 라이브러리에서 대신 기본 클래스 예외 MemberAccessException을 catch합니다.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, MemberAccessException, instead.

클래스 내에서 개인 메서드 또는 보호된 메서드에 액세스하려는 잘못된 시도가 있었습니다.There was an illegal attempt to access a private or protected method inside a class.

속성 값을 설정할 때 오류가 발생했습니다.An error occurred while setting the property value. 예를 들어, 인덱싱된 속성에 대해 지정된 인덱스 값이 범위를 벗어났습니다.For example, an index value specified for an indexed property is out of range. InnerException 속성은 오류가 발생한 원인을 나타냅니다.The InnerException property indicates the reason for the error.

예제

다음 예제에서는 라는 클래스를 정의 TestClass 라는 읽기 / 쓰기 속성이 있는 Caption합니다.The following example defines a class named TestClass that has a read-write property named Caption. 기본 값을 표시 합니다 Caption 속성을 호출 하는 SetValue 속성 값을 변경 하는 방법 결과 표시 합니다.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.

때문에 합니다 Caption 속성을 매개 변수 배열이 아닙니다. 합니다 index 인수가 null합니다.Note that, because the Caption property is not a parameter array, the index argument is null.

다음 예제에서는 라는 클래스를 선언 Example 세 가지 속성을 사용 하 여:를 static 속성 (Shared Visual Basic의), 인덱싱된 인스턴스 속성과 인스턴스 속성을 합니다.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. 이 예제에서는 사용 된 SetValue 표시 원본 및 최종 값을 확인 하 고 속성의 기본값을 변경 하는 방법입니다.The example uses the SetValue method to change the default values of the properties and displays the original and final values.

리플렉션 사용 하 여 인덱싱된 인스턴스 속성 검색에 사용 되는 이름 속성에 적용 되는 특성 및 언어에 따라 다릅니다.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.

  • Visual basic에서는 리플렉션 사용 하 여 속성에 대 한 검색 속성 이름은 항상 사용 됩니다.In Visual Basic, the property name is always used to search for the property with reflection. 사용할 수는 Default 키워드는 속성을 기본값으로 설정 하려면 인덱싱된 속성,이 경우 이름을 생략할 수 있습니다는이 예제와 같이 속성에 액세스 하는 경우.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. 또한 속성 이름을 사용할 수 있습니다.You can also use the property name.

  • C#에서는 인덱싱된 인스턴스 속성 인덱서 라는 기본 속성 이며 코드에서 속성에 액세스 하는 경우에 이름이 사용 되지 않습니다.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. 기본적으로 속성의 이름은 Item, 리플렉션 사용 하 여 속성을 검색할 때 해당 이름을 사용 해야 합니다.By default, the name of the property is Item, and you must use that name when you search for the property with reflection. 사용할 수는 IndexerNameAttribute 인덱서에 다른 이름을 지정 하는 특성입니다.You can use the IndexerNameAttribute attribute to give the indexer a different name. 이 예제에서 이름은 IndexedInstanceProperty입니다.In this example, the name is IndexedInstanceProperty.

  • C + +에서는 default 지정자 기본 인덱싱된 속성을 만드는 데 사용할 수 있습니다 인덱싱된 속성 (클래스 인덱서).In C++, the default specifier can be used to make an indexed property a default indexed property (class indexer). 이 경우 기본적으로 속성의 이름은 Item,이 예제와 같이 리플렉션 사용 하 여 속성을 검색할 때 해당 이름을 사용 해야 합니다.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. 사용할 수는 IndexerNameAttribute 리플렉션에서 클래스 인덱서에 다른 이름을 지정 하는 특성 하지만 코드에서 속성에 액세스 하려면 해당 이름을 사용할 수 없습니다.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. 인덱싱된 속성 클래스 인덱서 없는 리플렉션 및 코드에서 모두 해당 이름을 사용 하 여 액세스 됩니다.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'

설명

이 경우 PropertyInfo 개체는 값 형식 및 valuenull, 속성을 해당 형식에 대 한 기본값으로 설정 됩니다.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.

속성을 인덱싱 되었는지 여부를 확인 하려면 사용 된 GetIndexParameters 메서드.To determine whether a property is indexed, use the GetIndexParameters method. 결과 배열에 0 (영) 요소가 속성은 인덱싱되지 않습니다.If the resulting array has 0 (zero) elements, the property is not indexed.

추상 런타임 구현을 호출 하는 편리한 방법입니다 SetValue(Object, Object, BindingFlags, Binder, Object[], CultureInfo) 메서드를 지정 하 BindingFlags.Default 에 대 한 합니다 BindingFlags 매개 변수를 null 에 대 한 Binder, 및 null 에 대 한 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.

사용 하 여 SetValue 메서드를 먼저 가져온을 Type 클래스를 나타내는 개체입니다.To use the SetValue method, first get a Type object that represents the class. Type, 가져오기는 PropertyInfo합니다.From the Type, get the PropertyInfo. PropertyInfo를 사용 하 여를 SetValue 메서드.From the PropertyInfo, use the SetValue method.

참고

부터 합니다 .NET Framework 2.0 서비스 팩 1.NET Framework 2.0 Service Pack 1,이 메서드를 사용 하 여 호출자에 게 부여 된 경우 public이 아닌 멤버에 액세스할 수 있습니다 ReflectionPermission 사용 하 여는 ReflectionPermissionFlag.RestrictedMemberAccess 플래그 및 public이 아닌 멤버의 권한 부여 집합 호출자 에게만 부여 된 집합 또는 하위 집합 그 합니다.Starting with the .NET Framework 2.0 서비스 팩 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. (참조 리플렉션의 보안 고려 사항.)(See Security Considerations for Reflection.)

이 기능을 사용하려면 애플리케이션이 .NET Framework 3.5.NET Framework 3.5 이상을 대상으로 해야 합니다.To use this functionality, your application should target the .NET Framework 3.5.NET Framework 3.5 or later.

보안

ReflectionPermission
호출 될 때 런타임에 바인딩된 메커니즘을 통해 같은 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[]). 연관된 열거형: MemberAccessAssociated enumeration: MemberAccess.

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

파생된 클래스에서 재정의된 경우 지정된 바인딩, 인덱스 및 문화별 정보가 있는 지정된 개체에 대해 속성 값을 설정합니다.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

매개 변수

obj
Object Object Object Object

속성 값이 설정될 개체입니다.The object whose property value will be set.

value
Object Object Object Object

새 속성 값입니다.The new property value.

invokeAttr
BindingFlags BindingFlags BindingFlags BindingFlags

호출 특성을 지정하는 InvokeMethod, CreateInstance, Static, GetField, SetField, GetProperty 또는 SetProperty 열거형 멤버의 비트 조합입니다.A bitwise combination of the following enumeration members that specify the invocation attribute: InvokeMethod, CreateInstance, Static, GetField, SetField, GetProperty, or SetProperty. 적합한 호출 특성을 지정해야 합니다.You must specify a suitable invocation attribute. 예를 들어 정적 멤버를 호출하려면 Static 플래그를 설정합니다.For example, to invoke a static member, set the Static flag.

binder
Binder Binder Binder Binder

리플렉션을 통해 바인딩, 인수 형식의 강제 변환, 멤버 호출 및 MemberInfo 개체 검색을 사용할 수 있도록 하는 개체입니다.An object that enables the binding, coercion of argument types, invocation of members, and retrieval of MemberInfo objects through reflection. bindernull이면 기본 바인더가 사용됩니다.If binder is null, the default binder is used.

index
Object[]

인덱싱된 속성에 대한 선택적 인덱스 값입니다.Optional index values for indexed properties. 인덱싱되지 않은 속성에 대해서는 이 값이 null이어야 합니다.This value should be null for non-indexed properties.

culture
CultureInfo CultureInfo CultureInfo CultureInfo

리소스를 지역화할 문화권입니다.The culture for which the resource is to be localized. 리소스가 이 문화권에 대해 지역화되지 않으면 Parent 속성이 연속적으로 호출되어 일치하는 문화권 정보를 검색합니다.If the resource is not localized for this culture, the Parent property will be called successively in search of a match. 이 값이 null이면 CurrentUICulture 속성에서 문화권별 정보를 가져옵니다.If this value is null, the culture-specific information is obtained from the CurrentUICulture property.

구현

예외

index 배열에 필요한 인수의 형식이 포함되어 있지 않습니다.The index array does not contain the type of arguments needed.

또는-or- 속성의 set 접근자를 찾을 수 없습니다.The property's set accessor is not found.

또는-or- valuePropertyType의 형식으로 변환할 수 없습니다.value cannot be converted to the type of PropertyType.

개체가 대상 형식과 일치하지 않거나 속성이 인스턴스 속성이지만 objnull입니다.The object does not match the target type, or a property is an instance property but obj is null.

index의 매개 변수 개수가 인덱싱된 속성 작업의 매개 변수 개수와 일치하지 않습니다.The number of parameters in index does not match the number of parameters the indexed property takes.

클래스 내에서 개인 메서드 또는 보호된 메서드에 액세스하려는 잘못된 시도가 있었습니다.There was an illegal attempt to access a private or protected method inside a class.

속성 값을 설정할 때 오류가 발생했습니다.An error occurred while setting the property value. 예를 들어, 인덱싱된 속성에 대해 지정된 인덱스 값이 범위를 벗어났습니다.For example, an index value specified for an indexed property is out of range. InnerException 속성은 오류가 발생한 원인을 나타냅니다.The InnerException property indicates the reason for the error.

설명

이 경우 PropertyInfo 개체는 값 형식 및 valuenull, 속성을 해당 형식에 대 한 기본값으로 설정 됩니다.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.

속성을 인덱싱 되었는지 여부를 확인 하려면 사용 된 GetIndexParameters 메서드.To determine whether a property is indexed, use the GetIndexParameters method. 결과 배열에 0 (영) 요소가 속성은 인덱싱되지 않습니다.If the resulting array has 0 (zero) elements, the property is not indexed.

완전히 신뢰할 수 있는 코드에 대 한 액세스 제한이 없습니다.Access restrictions are ignored for fully trusted code. 즉, 개인 생성자, 메서드, 필드 및 속성 액세스 하 고 수 코드를 완전히 신뢰할 수 있는 경우 리플렉션을 통해 호출 합니다.That is, private constructors, methods, fields, and properties can be accessed and invoked via Reflection whenever the code is fully trusted.

사용 하 여 SetValue 메서드를 먼저 클래스를 가져옵니다 Type합니다.To use the SetValue method, first get the class Type. Type, 가져오기는 PropertyInfo합니다.From the Type, get the PropertyInfo. PropertyInfo를 사용 하 여를 SetValue 메서드.From the PropertyInfo, use the SetValue method.

참고

부터 합니다 .NET Framework 2.0 서비스 팩 1.NET Framework 2.0 Service Pack 1,이 메서드를 사용 하 여 호출자에 게 부여 된 경우 public이 아닌 멤버에 액세스할 수 있습니다 ReflectionPermission 사용 하 여는 ReflectionPermissionFlag.RestrictedMemberAccess 플래그 및 public이 아닌 멤버의 권한 부여 집합 호출자 에게만 부여 된 집합 또는 하위 집합 그 합니다.Starting with the .NET Framework 2.0 서비스 팩 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. (참조 리플렉션의 보안 고려 사항.)(See Security Considerations for Reflection.)

이 기능을 사용하려면 애플리케이션이 .NET Framework 3.5.NET Framework 3.5 이상을 대상으로 해야 합니다.To use this functionality, your application should target the .NET Framework 3.5.NET Framework 3.5 or later.

보안

ReflectionPermission
호출 될 때 런타임에 바인딩된 메커니즘을 통해 같은 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[]). 연관된 열거형: MemberAccessAssociated enumeration: MemberAccess.

적용 대상