DependencyObject.CoerceValue(DependencyProperty) Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows
Assembly:
WindowsBase.dll

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.

public:
 void CoerceValue(System::Windows::DependencyProperty ^ dp);
public void CoerceValue (System.Windows.DependencyProperty dp);
member this.CoerceValue : System.Windows.DependencyProperty -> unit
Public Sub CoerceValue (dp As DependencyProperty)

Parametri

dp
DependencyProperty

Identificatore della proprietà di dipendenza da assegnare forzatamente.

Eccezioni

InvalidOperationException

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

Esempio

Nell'esempio seguente viene chiamato CoerceValue all'interno di un'implementazione PropertyChangedCallback usata come PropertyChangedCallback per proprietà di dipendenza diverse nella stessa classe. Si tratta di un modello comune per introdurre dipendenze di valore reale tra le proprietà di dipendenza.

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

Private Shared Sub OnCurrentReadingChanged(ByVal d As DependencyObject, ByVal e As DependencyPropertyChangedEventArgs)
    d.CoerceValue(MinReadingProperty)
    d.CoerceValue(MaxReadingProperty)
End Sub

Commenti

Oltre a essere richiamato in modo esplicito tramite la chiamata CoerceValuea , anche CoerceValueCallback per una proprietà di dipendenza viene richiamato internamente ogni volta che il valore della proprietà di dipendenza viene rivalutato dal sistema di proprietà WPF.

Quando si richiama il CoerceValue metodo, si richiama infine il callback del valore di coece per la proprietà specificata. In genere si richiamerà CoerceValue solo se si sa che esiste un callback di un valore di coercizione e se si conoscono i criteri del callback per la coercizione.

Lo scenario più comune per la chiamata CoerceValue è all'interno della gestione delle classi o dei callback delle modifiche delle proprietà correlate che influiscono sui valori degli altri in modo dipendente. Per altre informazioni, vedere Callback e convalida delle proprietà di dipendenza.

Si applica a

Vedi anche