DependencyObject.CoerceValue(DependencyProperty) Метод

Определение

Пространство имен:
System.Windows
Сборка:
WindowsBase.dll

Принуждает значение указанного свойства зависимостей. Это достигается путем вызова любой CoerceValueCallback функции, указанной в метаданных свойств для свойства зависимостей, так как он существует при вызове DependencyObject.

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)

Параметры

dp
DependencyProperty

Идентификатор свойства зависимостей для принудительного выполнения.

Исключения

InvalidOperationException

Указанное dp или его значение было недопустимым или не существует.

Примеры

В следующем примере вызывается CoerceValue реализация PropertyChangedCallback , которая используется в качестве PropertyChangedCallback разных свойств зависимостей в одном классе. Это распространенный шаблон для внедрения истинных зависимостей значений между свойствами зависимостей.

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

Комментарии

Помимо явного вызова CoerceValue, CoerceValueCallback для свойства зависимостей также вызывается внутренне при повторном вычислении значения свойства зависимостей системой свойств WPF.

При вызове метода вы в конечном итоге вызываете обратный CoerceValue вызов значения coerce для указанного свойства. Обычно вызовется CoerceValue только в том случае, если вы знаете, что обратный вызов принудительного значения существует, и если вы знаете критерии обратного вызова для приведения.

Наиболее распространенный сценарий вызова CoerceValue заключается в обработке классов или обратных вызовах изменений свойств связанных свойств, влияющих друг на друга значения в зависимости. Дополнительные сведения см. в разделе "Обратные вызовы свойств зависимостей" и "Проверка".

Применяется к

См. также раздел