PropertyInfo.SetValue Metode

Referensi

Definisi

Ruang nama:: System.Reflection

Rakitan:: System.Reflection.dll

Rakitan:: System.Runtime.dll

Rakitan:: mscorlib.dll

Rakitan:: netstandard.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mengatur nilai properti untuk objek tertentu.

Overload

SetValue(Object, Object)	Mengatur nilai properti dari objek tertentu.
SetValue(Object, Object, Object[])	Mengatur nilai properti objek tertentu dengan nilai indeks opsional untuk properti indeks.
SetValue(Object, Object, BindingFlags, Binder, Object[], CultureInfo)	Saat ditimpa di kelas turunan, menetapkan nilai properti untuk objek tertentu yang memiliki informasi pengikatan, indeks, dan khusus budaya yang ditentukan.

SetValue(Object, Object)

Sumber:: PropertyInfo.cs

Sumber:: PropertyInfo.cs

Sumber:: PropertyInfo.cs

Mengatur nilai properti dari objek tertentu.

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)

Parameter

obj: Object

Objek yang nilai propertinya akan diatur.

value: Object

Nilai properti baru.

Pengecualian

ArgumentException

Aksesor properti set tidak ditemukan.

-atau-

value tidak dapat dikonversi ke jenis PropertyType.

TargetException

Jenis obj tidak cocok dengan jenis target, atau properti adalah properti instans tetapi obj adalah null.

Catatan: Di .NET untuk aplikasi Bursa Windows atau Pustaka Kelas Portabel, tangkap Exception sebagai gantinya.

MethodAccessException

Ada upaya ilegal untuk mengakses metode privat atau dilindungi di dalam kelas.

Catatan: Di .NET untuk aplikasi Bursa Windows atau Pustaka Kelas Portabel, tangkap pengecualian kelas dasar, MemberAccessException, sebagai gantinya.

TargetInvocationException

Terjadi kesalahan saat mengatur nilai properti. Properti InnerException menunjukkan alasan kesalahan.

Contoh

Contoh berikut mendeklarasikan kelas bernama Example dengan satu static (Shared di Visual Basic) dan satu properti instans. Contohnya menggunakan SetValue(Object, Object) metode untuk mengubah nilai properti asli dan menampilkan nilai asli dan akhir.

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

Keterangan

Kelebihan SetValue(Object, Object) beban menetapkan nilai properti yang tidak diindeks. Untuk menentukan apakah properti diindeks, panggil GetIndexParameters metode . Jika array yang dihasilkan memiliki 0 (nol) elemen, properti tidak diindeks. Untuk mengatur nilai properti terindeks, panggil SetValue(Object, Object, Object[]) kelebihan beban.

Jika jenis properti objek ini PropertyInfo adalah jenis nilai dan value adalah null, properti akan diatur ke nilai default untuk jenis tersebut.

Ini adalah metode kenyamanan yang memanggil implementasi runtime dari metode abstrak SetValue(Object, Object, BindingFlags, Binder, Object[], CultureInfo) , menentukan BindingFlags.Default untuk BindingFlags parameter , null untuk Binder, null untuk Object[], dan null untuk CultureInfo.

Untuk menggunakan metode , pertama-tama SetValue Type dapatkan objek yang mewakili kelas . TypeDari , dapatkan PropertyInfo objek . Dari PropertyInfo objek , panggil SetValue metode .

Catatan

Dimulai dengan .NET Framework 2.0, metode ini dapat digunakan untuk mengakses anggota non-publik jika pemanggil telah diberikan ReflectionPermission dengan ReflectionPermissionFlag.RestrictedMemberAccess bendera dan jika set pemberian anggota non-publik dibatasi untuk set pemberian pemanggil, atau subsetnya. (Lihat Pertimbangan Keamanan untuk Refleksi.) Untuk menggunakan fungsionalitas ini, aplikasi Anda harus menargetkan .NET Framework 3.5 atau yang lebih baru.

Berlaku untuk

SetValue(Object, Object, Object[])

Sumber:: PropertyInfo.cs

Sumber:: PropertyInfo.cs

Sumber:: PropertyInfo.cs

Mengatur nilai properti objek tertentu dengan nilai indeks opsional untuk properti indeks.

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

Parameter

obj: Object

Objek yang nilai propertinya akan diatur.

value: Object

Nilai properti baru.

index: Object[]

Nilai indeks opsional untuk properti terindeks. Nilai ini harus null untuk properti yang tidak diindeks.

Penerapan

SetValue(Object, Object, Object[])

Pengecualian

ArgumentException

Array index tidak berisi jenis argumen yang diperlukan.

-atau-

Aksesor properti set tidak ditemukan.

-atau-

value tidak dapat dikonversi ke jenis PropertyType.

TargetException

Objek tidak cocok dengan jenis target, atau properti adalah properti instans tetapi obj adalah null.

Catatan: Di .NET untuk aplikasi Bursa Windows atau Pustaka Kelas Portabel, tangkap Exception sebagai gantinya.

TargetParameterCountException

Jumlah parameter di index tidak cocok dengan jumlah parameter yang diambil properti terindeks.

MethodAccessException

Ada upaya ilegal untuk mengakses metode privat atau dilindungi di dalam kelas.

Catatan: Di .NET untuk aplikasi Bursa Windows atau Pustaka Kelas Portabel, tangkap pengecualian kelas dasar, MemberAccessException, sebagai gantinya.

TargetInvocationException

Terjadi kesalahan saat mengatur nilai properti. Misalnya, nilai indeks yang ditentukan untuk properti terindeks berada di luar rentang. Properti InnerException menunjukkan alasan kesalahan.

Contoh

Contoh berikut mendefinisikan kelas bernama TestClass yang memiliki properti baca-tulis bernama Caption. Ini menampilkan nilai Caption default properti, memanggil SetValue metode untuk mengubah nilai properti, dan menampilkan hasilnya.

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.

Perhatikan bahwa, karena Caption properti bukan array parameter, index argumennya adalah null.

Contoh berikut mendeklarasikan kelas bernama Example dengan tiga properti: static properti (Shared di Visual Basic), properti instans, dan properti instans terindeks. Contohnya menggunakan SetValue metode untuk mengubah nilai default properti dan menampilkan nilai asli dan akhir.

Nama yang digunakan untuk mencari properti instans terindeks dengan pantulan berbeda tergantung pada bahasa dan atribut yang diterapkan ke properti .

Di Visual Basic, nama properti selalu digunakan untuk mencari properti dengan pantulan. Anda dapat menggunakan Default kata kunci untuk menjadikan properti sebagai properti terindeks default, dalam hal ini Anda dapat menghilangkan nama saat mengakses properti, seperti dalam contoh ini. Anda juga dapat menggunakan nama properti.
Di C#, properti instans terindeks adalah properti default yang disebut pengindeks, dan namanya tidak pernah digunakan saat mengakses properti dalam kode. Secara default, nama properti adalah Item, dan Anda harus menggunakan nama tersebut saat mencari properti dengan pantulan. Anda dapat menggunakan IndexerNameAttribute atribut untuk memberi pengindeks nama yang berbeda. Dalam contoh ini, tautannya adalah IndexedInstanceProperty.
Di C++, penentu default dapat digunakan untuk menjadikan properti terindeks sebagai properti terindeks default (pengindeks kelas). Dalam hal ini, nama properti secara default adalah Item, dan Anda harus menggunakan nama tersebut saat mencari properti dengan refleksi, seperti dalam contoh ini. Anda dapat menggunakan IndexerNameAttribute atribut untuk memberi pengindeks kelas nama yang berbeda dalam refleksi, tetapi Anda tidak dapat menggunakan nama tersebut untuk mengakses properti dalam kode. Properti terindeks yang bukan pengindeks kelas diakses menggunakan namanya, baik dalam kode maupun dalam pantulan.

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'

Keterangan

Jika objek ini PropertyInfo adalah jenis nilai dan value adalah null, maka properti akan diatur ke nilai default untuk jenis tersebut.

Untuk menentukan apakah properti diindeks, gunakan GetIndexParameters metode . Jika array yang dihasilkan memiliki 0 (nol) elemen, properti tidak diindeks.

Untuk menggunakan metode , pertama-tama SetValue Type dapatkan objek yang mewakili kelas . TypeDari , dapatkan PropertyInfo. PropertyInfoDari , gunakan SetValue metode .

Catatan

Berlaku untuk

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

Sumber:: PropertyInfo.cs

Sumber:: PropertyInfo.cs

Sumber:: PropertyInfo.cs

Saat ditimpa di kelas turunan, menetapkan nilai properti untuk objek tertentu yang memiliki pengikatan, indeks, dan informasi khusus budaya yang ditentukan.

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)

Parameter

obj: Object

Objek yang nilai propertinya akan diatur.

value: Object

Nilai properti baru.

invokeAttr: BindingFlags

Kombinasi bit dari anggota enumerasi berikut yang menentukan atribut pemanggilan: InvokeMethod, , CreateInstance, StaticGetField, SetField, GetProperty, atau SetProperty. Anda harus menentukan atribut pemanggilan yang sesuai. Misalnya, untuk memanggil anggota statis, atur Static bendera .

binder: Binder

Objek yang memungkinkan pengikatan, pemaksian jenis argumen, pemanggilan anggota, dan MemberInfo pengambilan objek melalui refleksi. Jika binder adalah null, pengikat default digunakan.

index: Object[]

Nilai indeks opsional untuk properti terindeks. Nilai ini harus null untuk properti yang tidak diindeks.

culture: CultureInfo

Budaya tempat sumber daya akan dilokalkan. Jika sumber daya tidak dilokalkan untuk budaya ini, Parent properti akan dipanggil secara berturut-turut untuk mencari kecocokan. Jika nilai ini adalah null, informasi khusus budaya diperoleh dari CurrentUICulture properti .

Penerapan

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

Pengecualian

ArgumentException

Array index tidak berisi jenis argumen yang diperlukan.

-atau-

Aksesor properti set tidak ditemukan.

-atau-

value tidak dapat dikonversi ke jenis PropertyType.

TargetException

Objek tidak cocok dengan jenis target, atau properti adalah properti instans tetapi obj adalah null.

TargetParameterCountException

Jumlah parameter di index tidak cocok dengan jumlah parameter yang diambil properti terindeks.

MethodAccessException

Ada upaya ilegal untuk mengakses metode privat atau dilindungi di dalam kelas.

TargetInvocationException

Terjadi kesalahan saat mengatur nilai properti. Misalnya, nilai indeks yang ditentukan untuk properti terindeks berada di luar rentang. Properti InnerException menunjukkan alasan kesalahan.

Keterangan

Jika objek ini PropertyInfo adalah jenis nilai dan value adalah null, maka properti akan diatur ke nilai default untuk jenis tersebut.

Untuk menentukan apakah properti diindeks, gunakan GetIndexParameters metode . Jika array yang dihasilkan memiliki 0 (nol) elemen, properti tidak diindeks.

Pembatasan akses diabaikan untuk kode yang sepenuhnya tepercaya. Artinya, konstruktor privat, metode, bidang, dan properti dapat diakses dan dipanggil melalui Pantulan setiap kali kode sepenuhnya dipercaya.

Untuk menggunakan metode ini, pertama-tama SetValue dapatkan kelas Type. TypeDari , dapatkan PropertyInfo. PropertyInfoDari , gunakan SetValue metode .

Catatan

Dimulai dengan .NET Framework 2.0, metode ini dapat digunakan untuk mengakses anggota non-publik jika pemanggil telah diberikan ReflectionPermission bendera ReflectionPermissionFlag.RestrictedMemberAccess dan jika set pemberian anggota non-publik dibatasi untuk set pemberian penelepon, atau subsetnya. (Lihat Pertimbangan Keamanan untuk Refleksi.) Untuk menggunakan fungsionalitas ini, aplikasi Anda harus menargetkan .NET Framework 3.5 atau yang lebih baru.

Berlaku untuk

Share via

PropertyInfo.SetValue Metode

Definisi

Overload

SetValue(Object, Object)

Parameter

Pengecualian

Contoh

Keterangan

Berlaku untuk

SetValue(Object, Object, Object[])

Parameter

Penerapan

Pengecualian

Contoh

Keterangan

Berlaku untuk

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

Parameter

Penerapan

Pengecualian

Keterangan

Berlaku untuk

Saran dan Komentar

Sumber Daya Tambahan: