PropertyInfo.SetValue Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Ustawia wartość właściwości dla określonego obiektu.
Przeciążenia
SetValue(Object, Object) |
Ustawia wartość właściwości określonego obiektu. |
SetValue(Object, Object, Object[]) |
Ustawia wartość właściwości określonego obiektu z opcjonalnymi wartościami indeksu dla właściwości indeksu. |
SetValue(Object, Object, BindingFlags, Binder, Object[], CultureInfo) |
Po zastąpieniu w klasie pochodnej ustawia wartość właściwości dla określonego obiektu, który ma określone powiązanie, indeks i informacje specyficzne dla kultury. |
SetValue(Object, Object)
- Źródło:
- PropertyInfo.cs
- Źródło:
- PropertyInfo.cs
- Źródło:
- PropertyInfo.cs
Ustawia wartość właściwości określonego obiektu.
public:
void SetValue(System::Object ^ obj, System::Object ^ value);
public void SetValue (object obj, object value);
public void SetValue (object? obj, object? value);
member this.SetValue : obj * obj -> unit
Public Sub SetValue (obj As Object, value As Object)
Parametry
- obj
- Object
Obiekt, którego wartość właściwości zostanie ustawiona.
- value
- Object
Nowa wartość właściwości.
Wyjątki
Nie można odnaleźć metody dostępu właściwości set
.
-lub-
value
nie można przekonwertować na typ .PropertyType
Typ obiektu nie jest zgodny z obj
typem docelowym lub właściwość jest właściwością wystąpienia, ale obj
jest null
.
Uwaga: w programie .NET dla aplikacji ze Sklepu Windows lub w przenośnej bibliotece klas przechwyć Exception zamiast tego.
W klasie wystąpiła nielegalna próba uzyskania dostępu do prywatnej lub chronionej metody.
Uwaga: na platformie .NET dla aplikacji ze Sklepu Windows lub przenośnej biblioteki klas przechwyć wyjątek klasy bazowej , MemberAccessExceptionzamiast tego.
Wystąpił błąd podczas ustawiania wartości właściwości. Właściwość InnerException wskazuje przyczynę błędu.
Przykłady
Poniższy przykład deklaruje klasę o nazwie Example
z jednym static
(Shared
w Visual Basic) i jedną właściwość wystąpienia. W przykładzie SetValue(Object, Object) użyto metody , aby zmienić oryginalne wartości właściwości i wyświetlić oryginalne i końcowe wartości.
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
Uwagi
Przeciążenie SetValue(Object, Object) ustawia wartość właściwości nieindeksowanej. Aby określić, czy właściwość jest indeksowana, wywołaj metodę GetIndexParameters . Jeśli wynikowa tablica ma 0 (zero), właściwość nie jest indeksowana. Aby ustawić wartość indeksowanej właściwości, wywołaj przeciążenie SetValue(Object, Object, Object[]) .
Jeśli typ właściwości tego PropertyInfo obiektu jest typem wartości i value
jest null
, właściwość zostanie ustawiona na wartość domyślną dla tego typu.
Jest to metoda wygody, która wywołuje implementację środowiska uruchomieniowego metody abstrakcyjnejSetValue(Object, Object, BindingFlags, Binder, Object[], CultureInfo), określając BindingFlags.Default parametr , dla parametru BindingFlags
, null
null
dla Object[]
Binder
, i null
dla CultureInfo
.
Aby użyć SetValue metody, najpierw pobierz obiekt reprezentujący klasę Type . Z obiektu Typepobierz PropertyInfo obiekt . Z obiektu wywołaj PropertyInfo metodę SetValue .
Uwaga
Począwszy od .NET Framework 2.0, ta metoda może służyć do uzyskiwania dostępu do niepublizowanych członków, jeśli obiekt wywołujący otrzymał ReflectionPermissionReflectionPermissionFlag.RestrictedMemberAccess flagę, a zestaw dotacji niepublizowanych członków jest ograniczony do zestawu dotacji osoby wywołującej lub jego podzbioru. (Zobacz Zagadnienia dotyczące zabezpieczeń do odbicia). Aby korzystać z tej funkcji, aplikacja powinna być docelowa .NET Framework 3.5 lub nowszej.
Dotyczy
SetValue(Object, Object, Object[])
- Źródło:
- PropertyInfo.cs
- Źródło:
- PropertyInfo.cs
- Źródło:
- PropertyInfo.cs
Ustawia wartość właściwości określonego obiektu z opcjonalnymi wartościami indeksu dla właściwości indeksu.
public:
virtual void SetValue(System::Object ^ obj, System::Object ^ value, cli::array <System::Object ^> ^ index);
public virtual void SetValue (object obj, object value, object[] index);
public virtual void SetValue (object? obj, object? value, object?[]? index);
abstract member SetValue : obj * obj * obj[] -> unit
override this.SetValue : obj * obj * obj[] -> unit
Public Overridable Sub SetValue (obj As Object, value As Object, index As Object())
Parametry
- obj
- Object
Obiekt, którego wartość właściwości zostanie ustawiona.
- value
- Object
Nowa wartość właściwości.
- index
- Object[]
Opcjonalne wartości indeksu dla właściwości indeksowanych. Ta wartość powinna być null
przeznaczona dla właściwości nieindeksowanych.
Implementuje
Wyjątki
Tablica index
nie zawiera wymaganego typu argumentów.
-lub-
Nie można odnaleźć metody dostępu właściwości set
.
-lub-
value
nie można przekonwertować na typ .PropertyType
Obiekt nie jest zgodny z typem docelowym lub właściwość jest właściwością wystąpienia, ale obj
jest null
.
Uwaga: w programie .NET dla aplikacji ze Sklepu Windows lub w przenośnej bibliotece klas przechwyć Exception zamiast tego.
Liczba parametrów w elemecie index
nie jest zgodna z liczbą parametrów pobieraną przez indeksowaną właściwość.
W klasie wystąpiła nielegalna próba uzyskania dostępu do prywatnej lub chronionej metody.
Uwaga: na platformie .NET dla aplikacji ze Sklepu Windows lub przenośnej biblioteki klas przechwyć wyjątek klasy bazowej , MemberAccessExceptionzamiast tego.
Wystąpił błąd podczas ustawiania wartości właściwości. Na przykład wartość indeksu określona dla indeksowanej właściwości jest poza zakresem. Właściwość InnerException wskazuje przyczynę błędu.
Przykłady
Poniższy przykład definiuje klasę o nazwie TestClass
, która ma właściwość read-write o nazwie Caption
. Wyświetla wartość Caption
domyślną właściwości, wywołuje SetValue metodę , aby zmienić wartość właściwości i wyświetla wynik.
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.
Należy pamiętać, że ponieważ Caption
właściwość nie jest tablicą parametrów, index
argumentem jest null
.
Poniższy przykład deklaruje klasę o nazwie Example
o trzech właściwościach: static
właściwość (Shared
w Visual Basic), właściwość wystąpienia i właściwość indeksowanego wystąpienia. W przykładzie SetValue użyto metody , aby zmienić wartości domyślne właściwości i wyświetlić oryginalne i końcowe wartości.
Nazwa używana do wyszukiwania właściwości wystąpienia indeksowanego z odbiciem różni się w zależności od języka i atrybutów zastosowanych do właściwości.
W języku Visual Basic nazwa właściwości jest zawsze używana do wyszukiwania właściwości z odbiciem. Możesz użyć słowa kluczowego
Default
, aby właściwość jest domyślną właściwością indeksowaną, w takim przypadku można pominąć nazwę podczas uzyskiwania dostępu do właściwości, jak w tym przykładzie. Możesz również użyć nazwy właściwości.W języku C# właściwość indeksowanego wystąpienia jest właściwością domyślną o nazwie indeksator, a nazwa nigdy nie jest używana podczas uzyskiwania dostępu do właściwości w kodzie. Domyślnie nazwa właściwości to
Item
, i należy użyć tej nazwy podczas wyszukiwania właściwości z odbiciem. Możesz użyć atrybutu IndexerNameAttribute , aby nadać indeksatorowi inną nazwę. W tym przykładzie nazwa toIndexedInstanceProperty
.W języku C++specyfikator
default
może służyć do tworzenia indeksowanej właściwości domyślnej indeksowanej właściwości (indeksator klas). W takim przypadku domyślnie nazwa właściwości toItem
, i należy użyć tej nazwy podczas wyszukiwania właściwości z odbiciem, jak w tym przykładzie. Możesz użyć atrybutu , aby nadać indeksatorowi IndexerNameAttribute klasy inną nazwę w odbiciu, ale nie można użyć tej nazwy, aby uzyskać dostęp do właściwości w kodzie. Do indeksowanej właściwości, która nie jest indeksatorem klasy, uzyskuje się dostęp przy użyciu jego nazwy, zarówno w kodzie, jak i w odbiciu.
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'
Uwagi
Jeśli ten PropertyInfo obiekt jest typem wartości i value
jest null
, właściwość zostanie ustawiona na wartość domyślną dla tego typu.
Aby określić, czy właściwość jest indeksowana, użyj GetIndexParameters metody . Jeśli wynikowa tablica ma 0 (zero), właściwość nie jest indeksowana.
Jest to metoda wygody, która wywołuje implementację środowiska uruchomieniowego metody abstrakcyjnejSetValue(Object, Object, BindingFlags, Binder, Object[], CultureInfo), określając BindingFlags.Default parametr BindingFlags
, null
dla , i null
dla Binder
CultureInfo
.
Aby użyć SetValue metody, najpierw pobierz obiekt reprezentujący klasę Type . W pliku Typepobierz element PropertyInfo. W metodzie PropertyInfoużyj SetValue metody .
Uwaga
Począwszy od .NET Framework 2.0, ta metoda może służyć do uzyskiwania dostępu do niepublizowanych członków, jeśli obiekt wywołujący otrzymał ReflectionPermissionReflectionPermissionFlag.RestrictedMemberAccess flagę, a zestaw dotacji niepublizowanych członków jest ograniczony do zestawu dotacji osoby wywołującej lub jego podzbioru. (Zobacz Zagadnienia dotyczące zabezpieczeń do odbicia). Aby korzystać z tej funkcji, aplikacja powinna być docelowa .NET Framework 3.5 lub nowszej.
Dotyczy
SetValue(Object, Object, BindingFlags, Binder, Object[], CultureInfo)
- Źródło:
- PropertyInfo.cs
- Źródło:
- PropertyInfo.cs
- Źródło:
- PropertyInfo.cs
Po zastąpieniu w klasie pochodnej ustawia wartość właściwości dla określonego obiektu, który ma określone powiązania, indeks i informacje specyficzne dla kultury.
public:
abstract void SetValue(System::Object ^ obj, System::Object ^ value, System::Reflection::BindingFlags invokeAttr, System::Reflection::Binder ^ binder, cli::array <System::Object ^> ^ index, System::Globalization::CultureInfo ^ culture);
public abstract void SetValue (object? obj, object? value, System.Reflection.BindingFlags invokeAttr, System.Reflection.Binder? binder, object?[]? index, System.Globalization.CultureInfo? culture);
public abstract void SetValue (object obj, object value, System.Reflection.BindingFlags invokeAttr, System.Reflection.Binder binder, object[] index, System.Globalization.CultureInfo culture);
abstract member SetValue : obj * obj * System.Reflection.BindingFlags * System.Reflection.Binder * obj[] * System.Globalization.CultureInfo -> unit
Public MustOverride Sub SetValue (obj As Object, value As Object, invokeAttr As BindingFlags, binder As Binder, index As Object(), culture As CultureInfo)
Parametry
- obj
- Object
Obiekt, którego wartość właściwości zostanie ustawiona.
- value
- Object
Nowa wartość właściwości.
- invokeAttr
- BindingFlags
Bitowa kombinacja następujących elementów członkowskich wyliczenia, które określają atrybut wywołania: InvokeMethod
, , CreateInstance
, SetField
GetProperty
Static
GetField
, lub .SetProperty
Należy określić odpowiedni atrybut wywołania. Aby na przykład wywołać statyczny element członkowski, ustaw flagę Static
.
- binder
- Binder
Obiekt, który umożliwia powiązanie, wymuszanie typów argumentów, wywołanie elementów członkowskich i pobieranie MemberInfo obiektów przez odbicie. Jeśli binder
jest to null
, jest używany domyślny binder.
- index
- Object[]
Opcjonalne wartości indeksu dla właściwości indeksowanych. Ta wartość powinna dotyczyć null
właściwości nieindeksowanych.
- culture
- CultureInfo
Kultura, dla której zasób ma być zlokalizowany. Jeśli zasób nie jest zlokalizowany dla tej kultury, Parent właściwość będzie wywoływana kolejno w wyszukiwaniu dopasowania. Jeśli ta wartość to null
, informacje specyficzne dla kultury są uzyskiwane z CurrentUICulture właściwości .
Implementuje
Wyjątki
Tablica index
nie zawiera wymaganego typu argumentów.
-lub-
Nie można odnaleźć metody dostępu właściwości set
.
-lub-
value
nie można przekonwertować na typ .PropertyType
Obiekt nie jest zgodny z typem docelowym lub właściwość jest właściwością wystąpienia, ale obj
jest null
.
Liczba parametrów w elemecie index
nie jest zgodna z liczbą parametrów pobieraną przez indeksowaną właściwość.
W klasie wystąpiła nielegalna próba uzyskania dostępu do prywatnej lub chronionej metody.
Wystąpił błąd podczas ustawiania wartości właściwości. Na przykład wartość indeksu określona dla indeksowanej właściwości jest poza zakresem. Właściwość InnerException wskazuje przyczynę błędu.
Uwagi
Jeśli ten PropertyInfo obiekt jest typem wartości i value
ma null
wartość , właściwość zostanie ustawiona na wartość domyślną tego typu.
Aby określić, czy właściwość jest indeksowana, użyj GetIndexParameters metody . Jeśli wynikowa tablica zawiera 0 (zero), właściwość nie jest indeksowana.
Ograniczenia dostępu są ignorowane dla w pełni zaufanego kodu. Oznacza to, że dostęp do prywatnych konstruktorów, metod, pól i właściwości można uzyskiwać i wywoływać za pośrednictwem odbicia za każdym razem, gdy kod jest w pełni zaufany.
Aby użyć SetValue
metody , najpierw pobierz klasę Type
. W pliku Type
pobierz element PropertyInfo
. W pliku PropertyInfo
użyj SetValue
metody .
Uwaga
Począwszy od .NET Framework 2.0, ta metoda może służyć do uzyskiwania dostępu do elementów członkowskich innych niż publiczne, jeśli obiekt wywołujący otrzymał ReflectionPermission flagęReflectionPermissionFlag.RestrictedMemberAccess, a zestaw dotacji niepublikowych członków jest ograniczony do zestawu dotacji osoby wywołującej lub jego podzbioru. (Zobacz Zagadnienia dotyczące zabezpieczeń dotyczące odbicia). Aby korzystać z tej funkcji, aplikacja powinna być docelowa .NET Framework 3.5 lub nowszą.
Dotyczy
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla