This documentation is archived and is not being maintained.

ValueSource.IsCoerced Property

Gets a value that declares whether this value resulted from a CoerceValueCallback implementation applied to a dependency property.

Namespace:  System.Windows
Assembly:  PresentationFramework (in PresentationFramework.dll)

public bool IsCoerced { get; }

Property Value

Type: System.Boolean
true if the value resulted from a CoerceValueCallback implementation applied to a dependency property; otherwise, false.

If coercion is acting on a property value, the property retains a desired value, and the property value will attempt to reach that desired value if the constraints of the specific coercion are changed or lifted. A coerced property that is not at its desired value will report that IsCoerced is true.

Coercion acts at higher precedence than the base value, and is not strictly speaking a participant in how the base value is set. Therefore the state of being coerced is reported by this property, rather than by a value of the BaseValueSource enumeration. For more information about coercion, base values, and precedence, see Dependency Property Value Precedence.

.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: