Class ThisPropertyDescriptor<T>

Definition

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

Special descriptor used for "this" references in argument/attribute bindings, allowing them to reference the current context instead of a property on it.

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

Type Parameters

T
The object type.

Inheritance
Object ⇦ ThisPropertyDescriptor<T>

Implements
IPropertyDescriptor<T>, IPropertyDescriptor, IMemberDescriptor

Members

Fields

Name	Description
Instance	Gets the singleton descriptor instance for the current object/property type.

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
GetValue(Object)	Reads the current property value.
SetValue(Object, T)	Writes a new property value.

Details

Fields

Instance

Gets the singleton descriptor instance for the current object/property type.

public static readonly StardewUI.Framework.Descriptors.ThisPropertyDescriptor<T> Instance;

Field Value

ThisPropertyDescriptor<T>

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

GetValue(Object)

Reads the current property value.

public T GetValue(System.Object source);

Parameters

source Object
An instance of the property's DeclaringType.

Returns

T

SetValue(Object, T)

Writes a new property value.

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

Parameters

target Object
An instance of the property's DeclaringType.

value T
The new property value.