DependencyObject.OnPropertyChanged(DependencyPropertyChangedEventArgs) Метод

Определение

Вызывается при каждом обновлении эффективного значения любого свойства DependencyObject зависимостей. Определенное свойство зависимостей, которое изменилось, сообщается в данных события.

protected:
 virtual void OnPropertyChanged(System::Windows::DependencyPropertyChangedEventArgs e);
protected virtual void OnPropertyChanged(System.Windows.DependencyPropertyChangedEventArgs e);
abstract member OnPropertyChanged : System.Windows.DependencyPropertyChangedEventArgs -> unit
override this.OnPropertyChanged : System.Windows.DependencyPropertyChangedEventArgs -> unit
Protected Overridable Sub OnPropertyChanged (e As DependencyPropertyChangedEventArgs)

Параметры

e
DependencyPropertyChangedEventArgs

Данные событий, которые будут содержать идентификатор свойства зависимостей, интересующих вас, метаданные свойства для типа и старые и новые значения.

Комментарии

Этот метод не предназначен для того, чтобы обычно обнаруживать изменения отдельных свойств или выполнять недопустимые свойства на основе каждого регистра. OnPropertyChanged вместо этого предназначен для изменения общего шаблона недопустимости, если некоторые сведения известны о широких классификациях свойств. Например, изменения в объекте Freezable могут быть изменены в типах значений Freezableили могут быть вложенными, где изменения находятся в других Freezable ссылках. Реализация Freezable переопределения OnPropertyChanged использует внутреннюю информацию для определения того, являются ли свойства вложенными и предоставляют соответствующую логику базового класса для любого случая.

OnPropertyChanged потенциально вызывается много раз в течение жизни объекта. Таким образом, можно повысить производительность для общей системы свойств, если переопределить метаданные определенных свойств, а затем присоединить CoerceValueCallback или PropertyChangedCallback функции для отдельных свойств. Однако этот метод будет использоваться, если в DependencyObject нем содержится значительное количество свойств зависимостей, связанных со значением, или если он включает логику, например поведение отрисовки, которое необходимо повторно запустить для нескольких связанных случаев недопустимых свойств.

Примечания для тех, кто наследует этот метод

Всегда вызывайте базовую реализацию. Сбой этого значительно отключит всю систему свойств WPF, что приводит к возникновению неверных значений.

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

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