Class ReflectionPropertyDescriptor<T, TValue>

Definition

Namespace: StardewUI.Framework.Descriptors
Assembly: StardewUI.dll

Binding property based on reflection.

public class ReflectionPropertyDescriptor<T, TValue> : 
    StardewUI.Framework.Descriptors.IPropertyDescriptor<TValue>, 
    StardewUI.Framework.Descriptors.IPropertyDescriptor, 
    StardewUI.Framework.Descriptors.IMemberDescriptor

Type Parameters

T
The type on which the property is declared.

TValue
The property's value type.

Inheritance
Object ⇦ ReflectionPropertyDescriptor<T, TValue>

Implements
IPropertyDescriptor<TValue>, IPropertyDescriptor, IMemberDescriptor

Members

Constructors

Name	Description
ReflectionPropertyDescriptor<T, TValue>(PropertyInfo)	Initializes a new ReflectionPropertyDescriptor from reflected property info.

Properties

Name	Description
CanRead	Whether or not the property is readable, i.e. has a public getter.
CanWrite	Whether or not the property is writable, i.e. has a public setter.
DeclaringType	The type on which the member is declared.
IsAutoProperty	Whether or not the property is likely auto-implemented.
IsField	Whether or not the underlying member is a field, rather than a real property.
Name	The member name.
ValueType	The property's value type.

Methods

Name	Description
Equals(Object)	(Overrides Object.`Equals(Object)`)
GetHashCode()	(Overrides Object.`GetHashCode()`)
GetValue(Object)	Reads the current property value.
SetValue(Object, TValue)	Writes a new property value.

Details

Constructors

ReflectionPropertyDescriptor<T, TValue>(PropertyInfo)

Initializes a new ReflectionPropertyDescriptor from reflected property info.

public ReflectionPropertyDescriptor<T, TValue>(System.Reflection.PropertyInfo propertyInfo);

Parameters

propertyInfo PropertyInfo
The reflected property info.

Properties

CanRead

Whether or not the property is readable, i.e. has a public getter.

public bool CanRead { get; }

Property Value

Boolean

CanWrite

Whether or not the property is writable, i.e. has a public setter.

public bool CanWrite { get; }

Property Value

Boolean

DeclaringType

The type on which the member is declared.

public System.Type DeclaringType { get; }

Property Value

Type

IsAutoProperty

Whether or not the property is likely auto-implemented.

public bool IsAutoProperty { get; }

Property Value

Boolean

Remarks

Auto-property detection is heuristic, relying on the method's IL instructions and the name of its backing field. This can often be interpreted as a signal that the property won't receive property-change notifications, since to do so (whether explicitly or via some weaver/source generator) requires an implementation that is different from the auto-generated getter and setter.

Caveats: This only works as a negative signal (a value of false does not prove that the property will receive notifications, even if the declaring type implements INotifyPropertyChanged), and is somewhat fuzzy even as a negative signal; it is theoretically possible for a source generator or IL weaver to leave behind all the markers of an auto property and still emit notifications, although no known libraries actually do so.

IsField

Whether or not the underlying member is a field, rather than a real property.

public bool IsField { get; }

Property Value

Boolean

Remarks

For binding convenience, fields and properties are both called "properties" for descriptors, as the external access pattern is the same; however, mutable fields can never reliably emit property-change notifications regardless of whether the declaring type implements INotifyPropertyChanged, so this is usually used to emit some warning.

Name

The member name.

public string Name { get; }

Property Value

string

ValueType

The property's value type.

public System.Type ValueType { get; }

Property Value

Type

Methods

Equals(Object)

public override bool Equals(System.Object obj);

Parameters

obj Object

Returns

Boolean

GetHashCode()

public override int GetHashCode();

Returns

Int32

GetValue(Object)

Reads the current property value.

public TValue GetValue(System.Object source);

Parameters

source Object
An instance of the property's DeclaringType.

Returns

TValue

SetValue(Object, TValue)

Writes a new property value.

public void SetValue(System.Object target, TValue value);

Parameters

target Object
An instance of the property's DeclaringType.

value TValue
The new property value.