Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo DependencyObject.CoerceValue (DependencyProperty)

 

Data di pubblicazione: novembre 2016

Assegna forzatamente il valore della proprietà di dipendenza specificata. Questa operazione viene eseguita richiamando qualsiasi funzione CoerceValueCallback specificata nei metadati della proprietà di dipendenza esistente nell'oggetto DependencyObject chiamante.

Spazio dei nomi:   System.Windows
Assembly:  WindowsBase (in WindowsBase.dll)

public void CoerceValue(
	DependencyProperty dp
)

Parametri

dp
Type: System.Windows.DependencyProperty

Identificatore della proprietà di dipendenza da assegnare forzatamente.

Exception Condition
InvalidOperationException

Il parametro dp specificato o il relativo valore non è valido o non esiste.

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
Disponibile da 3.0
Torna all'inizio
Mostra: