PropertyInfo.SetValue Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Задает значение свойства для указанного объекта.
Перегрузки
| SetValue(Object, Object) |
Задает значение свойства для указанного объекта. |
| SetValue(Object, Object, Object[]) |
Задает значение свойства заданного объекта с дополнительными значениями индекса для индексированных свойств. |
| SetValue(Object, Object, BindingFlags, Binder, Object[], CultureInfo) |
При переопределении в производном классе задает значение свойства для заданного объекта, имеющего указанные сведения о привязке, индексе и языке и региональных параметрах. |
SetValue(Object, Object)
Задает значение свойства для указанного объекта.
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 -> unitPublic Sub SetValue (obj As Object, value As Object)Параметры
- obj
- Object
Объект, значение свойства которого будет установлено.
- value
- Object
Новое значение свойства.
Исключения
Тип obj не соответствует целевому типу, или свойство является свойством экземпляра, но obj равен null.
Примечание. Вместо этого в .NET для приложений Магазина Windows или переносимой библиотеке классов выполните перехват Exception .
Недопустимая попытка доступа к частному или защищенному методу внутри класса.
Примечание. Вместо этого в .NET для приложений Магазина Windows или переносимой библиотеке классов перехватите исключение MemberAccessExceptionбазового класса , .
Ошибка при установке значения свойства. Свойство InnerException содержит причину данной ошибки.
Примеры
В следующем примере объявляется класс с именем Example с одним static (Shared в Visual Basic) и одним свойством экземпляра. В примере метод используется для SetValue(Object, Object) изменения исходных значений свойств и отображения исходных и конечных значений.
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) задает значение неиндексированного свойства. Чтобы определить, индексируется ли свойство, вызовите GetIndexParameters метод . Если результирующий массив содержит 0 (ноль) элементов, свойство не индексируется. Чтобы задать значение индексированного свойства, вызовите перегрузку SetValue(Object, Object, Object[]) .
Если тип свойства этого PropertyInfo объекта является типом значения и value имеет значение null, свойству будет присвоено значение по умолчанию для этого типа.
Это удобный метод, который вызывает реализацию абстрактного SetValue(Object, Object, BindingFlags, Binder, Object[], CultureInfo) метода среды выполнения, указывая BindingFlags.Default для BindingFlags параметра , nullnull для BinderObject[], и null для CultureInfo.
Чтобы использовать SetValue метод , сначала получите Type объект , представляющий класс . TypeИз получите PropertyInfo объект . PropertyInfo Из объекта вызовите SetValue метод .
Примечание
Начиная с платформа .NET Framework 2.0, этот метод можно использовать для доступа к элементам, не являющиеся открытыми, если вызывающему объекту предоставлен ReflectionPermissionReflectionPermissionFlag.RestrictedMemberAccess флаг и если набор разрешений для не открытых элементов ограничен набором разрешений вызывающего объекта или его подмножеством. (См. раздел Вопросы безопасности для отражения.) Чтобы использовать эту функцию, приложение должно быть ориентировано на платформа .NET Framework 3.5 или более поздней версии.
Применяется к
SetValue(Object, Object, Object[])
Задает значение свойства заданного объекта с дополнительными значениями индекса для индексированных свойств.
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[] -> unitPublic Overridable Sub SetValue (obj As Object, value As Object, index As Object())Параметры
- obj
- Object
Объект, значение свойства которого будет установлено.
- value
- Object
Новое значение свойства.
- index
- Object[]
Необязательные значения индекса для индексированных свойств. Для неиндексированных свойств это значение должно быть равно null.
Реализации
Исключения
Массив index не содержит необходимого типа аргументов.
-или-
Не найден метод доступа set свойства.
-или-
value невозможно преобразовать в тип PropertyType.
Объект не соответствует целевому типу, или свойство является свойством экземпляра, но obj равен null.
Примечание. Вместо этого в .NET для приложений Магазина Windows или переносимой библиотеке классов выполните перехват Exception .
Число параметров в index не соответствует числу параметров, принимаемых индексированным свойством.
Недопустимая попытка доступа к частному или защищенному методу внутри класса.
Примечание. Вместо этого в .NET для приложений Магазина Windows или переносимой библиотеке классов перехватите исключение MemberAccessExceptionбазового класса , .
Произошла ошибка при установке значения свойства. Например, значение индекса, указанное для индексированного свойства, находится вне диапазона. Свойство InnerException содержит причину данной ошибки.
Примеры
В следующем примере определяется класс с именем TestClass , имеющий свойство чтения и записи с именем Caption. Он отображает значение Caption свойства по умолчанию, вызывает SetValue метод для изменения значения свойства и отображает результат.
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.
Обратите внимание, что, поскольку Caption свойство не является массивом параметров, аргументом index является null.
В следующем примере объявляется класс с тремя Example свойствами: static свойство (Shared в Visual Basic), свойство экземпляра и свойство индексированного экземпляра. В этом примере метод используется SetValue для изменения значений свойств по умолчанию и отображает исходные и конечные значения.
Имя, используемое для поиска свойства индексированного экземпляра с отражением, отличается в зависимости от языка и атрибутов, применяемых к свойству.
В Visual Basic имя свойства всегда используется для поиска свойства с отражением. Вы можете использовать ключевое слово ,
Defaultчтобы сделать свойство индексировано по умолчанию. В этом случае имя можно опустить при доступе к свойству, как показано в этом примере. Вы также можете использовать имя свойства.В C# свойство индексированного экземпляра является свойством по умолчанию, которое называется индексатором, и имя никогда не используется при доступе к свойству в коде. По умолчанию свойство имеет
Itemимя , и его необходимо использовать при поиске свойства с отражением. Атрибут можно использовать для IndexerNameAttribute присвоения индексатору другого имени. В данном примере это имяIndexedInstanceProperty.В C++
defaultописатель можно использовать для создания индексированного свойства индексированного свойства по умолчанию (индексатор класса). В этом случае имя свойства по умолчанию равноItem, и это имя необходимо использовать при поиске свойства с отражением, как показано в этом примере. Атрибут можно использовать для IndexerNameAttribute присвоения индексатору класса другого имени в отражении, но нельзя использовать это имя для доступа к свойству в коде. Доступ к индексизованному свойству, которое не является индексатором класса, осуществляется по его имени как в коде, так и в отражении.
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 объект является типом значения и value имеет значение null, то свойству будет присвоено значение по умолчанию для этого типа.
Чтобы определить, индексируется ли свойство, используйте GetIndexParameters метод . Если результирующий массив содержит 0 (ноль) элементов, свойство не индексируется.
Это удобный метод, который вызывает реализацию абстрактного SetValue(Object, Object, BindingFlags, Binder, Object[], CultureInfo) метода среды выполнения, указывая BindingFlags.Default для BindingFlags параметра , null для Binderи null для CultureInfo.
Чтобы использовать SetValue метод , сначала получите Type объект , представляющий класс . TypeИз получите PropertyInfo. В используйте PropertyInfoSetValue метод .
Примечание
Начиная с платформа .NET Framework 2.0, этот метод можно использовать для доступа к элементам, не являющиеся открытыми, если вызывающему объекту предоставлен ReflectionPermissionReflectionPermissionFlag.RestrictedMemberAccess флаг и если набор разрешений для не открытых элементов ограничен набором разрешений вызывающего объекта или его подмножеством. (См. раздел Вопросы безопасности для отражения.) Чтобы использовать эту функцию, приложение должно быть ориентировано на платформа .NET Framework 3.5 или более поздней версии.
Применяется к
SetValue(Object, Object, BindingFlags, Binder, Object[], CultureInfo)
При переопределении в производном классе задает значение свойства для заданного объекта, имеющего указанные сведения о привязке, индексе и языке и региональных параметрах.
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 -> unitPublic MustOverride Sub SetValue (obj As Object, value As Object, invokeAttr As BindingFlags, binder As Binder, index As Object(), culture As CultureInfo)Параметры
- obj
- Object
Объект, значение свойства которого будет установлено.
- value
- Object
Новое значение свойства.
- invokeAttr
- BindingFlags
Битовая комбинация следующих членов перечисления, определяющих атрибут вызова: InvokeMethod, CreateInstance, Static, GetField, SetField, GetProperty или SetProperty. Необходимо указать подходящий атрибут вызова. Например, чтобы вызвать статический член, установите флаг Static.
- binder
- Binder
Объект, который допускает привязку, приведение типов аргументов, вызов элементов и извлечение объектов MemberInfo путем отражения. Если значение параметра binder равно null, используется связыватель по умолчанию.
- index
- Object[]
Необязательные значения индекса для индексированных свойств. Для неиндексированных свойств это значение должно быть равно null.
- culture
- CultureInfo
Язык и региональные параметры, для которых должен быть локализован данный ресурс. Если ресурс не локализован для данного языка и региональных параметров, при поиске соответствия будет последовательно вызываться свойство Parent. Если это значение равно null, из свойства CurrentUICulture получаются сведения, относящиеся к конкретному языку и региональным параметрам.
Реализации
Исключения
Массив index не содержит необходимого типа аргументов.
-или-
Не найден метод доступа set свойства.
-или-
value невозможно преобразовать в тип PropertyType.
Объект не соответствует целевому типу, или свойство является свойством экземпляра, но obj равен null.
Число параметров в index не соответствует числу параметров, принимаемых индексированным свойством.
Недопустимая попытка доступа к частному или защищенному методу внутри класса.
Произошла ошибка при установке значения свойства. Например, значение индекса, указанное для индексированного свойства, находится вне диапазона. Свойство InnerException содержит причину данной ошибки.
Комментарии
Если этот PropertyInfo объект является типом значения и value имеет значение null, то свойству будет присвоено значение по умолчанию для этого типа.
Чтобы определить, индексируется ли свойство, используйте GetIndexParameters метод . Если результирующий массив содержит 0 (ноль) элементов, свойство не индексируется.
Ограничения доступа игнорируются для полностью доверенного кода. То есть к закрытым конструкторам, методам, полям и свойствам можно обращаться и вызывать через отражение всякий раз, когда код является полностью доверенным.
Чтобы использовать SetValue метод , сначала получите класс Type. TypeИз получите PropertyInfo. В используйте PropertyInfoSetValue метод .
Примечание
Начиная с платформа .NET Framework 2.0, этот метод можно использовать для доступа к не открытым членам, если вызывающему объекту был предоставлен ReflectionPermissionReflectionPermissionFlag.RestrictedMemberAccess флаг и если набор разрешений для не открытых элементов ограничен набором разрешений вызывающего объекта или его подмножеством. (См. раздел Вопросы безопасности для отражения.) Чтобы использовать эту функцию, приложение должно быть предназначено для платформа .NET Framework 3.5 или более поздней версии.
Применяется к
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе: https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по