Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

DependencyObject.CoerceValue-Methode: (DependencyProperty)

 

Veröffentlicht: Oktober 2016

Erzwingt den Wert der angegebenen Abhängigkeitseigenschaft. Dies erfolgt durch den Aufruf einer beliebigen CoerceValueCallback-Funktion, die in den Metadaten für die Abhängigkeitseigenschaft angegeben ist, während sie beim aufrufenden DependencyObject beendet wird.

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

public void CoerceValue(
	DependencyProperty dp
)

Parameter

dp
Type: System.Windows.DependencyProperty

Der Bezeichner für die zu erzwingende Abhängigkeitseigenschaft.

Exception Condition
InvalidOperationException

Der angegebene dp oder sein Wert waren ungültig oder sind nicht vorhanden.

In addition to being explicitly invoked through calling M:System.Windows.DependencyObject.CoerceValue(System.Windows.DependencyProperty), the T:System.Windows.CoerceValueCallback for a dependency property is also invoked internally whenever the dependency property value is being re-evaluated by the TLA2#tla_winclient property system.

When you invoke the M:System.Windows.DependencyObject.CoerceValue(System.Windows.DependencyProperty) method, you are ultimately invoking the coerce value callback for the property that you specify. Typically you will invoke M:System.Windows.DependencyObject.CoerceValue(System.Windows.DependencyProperty) only if you know that a coerce value callback exists, and if you know the callback's criteria for coercion.

The most common scenario for calling M:System.Windows.DependencyObject.CoerceValue(System.Windows.DependencyProperty) is within class handling or property change callbacks of related properties that influence each other's values in a dependent way. For more information, see Dependency Property Callbacks and Validation.

The following example calls M:System.Windows.DependencyObject.CoerceValue(System.Windows.DependencyProperty) within a T:System.Windows.PropertyChangedCallback implementation that is used as the P:System.Windows.PropertyMetadata.PropertyChangedCallback for a different dependency properties on the same class. This is a common pattern for introducing true value dependencies between dependency properties.

private static void OnCurrentReadingChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
{
  d.CoerceValue(MinReadingProperty);
  d.CoerceValue(MaxReadingProperty);
}

.NET Framework
Verfügbar seit 3.0
Zurück zum Anfang
Anzeigen: