DependencyObject.OnPropertyChanged(DependencyPropertyChangedEventArgs) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Invocado sempre que o valor efetivo de qualquer propriedade de dependência tiver DependencyObject sido atualizado. A propriedade de dependência específica que foi alterada é relatada nos dados do evento.
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 -> unitProtected Overridable Sub OnPropertyChanged (e As DependencyPropertyChangedEventArgs)Parâmetros
Dados de evento que conterão o identificador de propriedade de dependência de interesse, os metadados de propriedade para o tipo e valores antigos e novos.
Comentários
Esse método não se destina a detectar geralmente alterações de propriedade individuais ou executar invalidações de propriedades por caso. OnPropertyChanged em vez disso, destina-se a modificações do padrão de invalidação geral, se determinadas informações forem conhecidas sobre classificações amplas de propriedades. Por exemplo, as alterações em um Freezable podem ser alterações nos tipos de valor do Freezable, ou podem ser subpropriedades, em que as alterações estão dentro de outras Freezable referências. A Freezable implementação de substituição usa OnPropertyChanged informações internas para determinar se as propriedades são subpropriedades e fornece a lógica de classe base apropriada para ambos os casos.
OnPropertyChanged é potencialmente invocado muitas vezes durante a vida útil de um objeto. Portanto, você poderá obter um melhor desempenho para o sistema de propriedades geral se substituir os metadados de propriedades específicas e, em seguida, anexar CoerceValueCallback ou PropertyChangedCallback funções para propriedades individuais. No entanto, você usaria esse método se inclua um DependencyObject número significativo de propriedades de dependência inter-relacionadas a valor ou se ele incluisse lógica, como comportamento de renderização que deve ser executado novamente para vários casos relacionados de invalidações de propriedade.
Notas aos Herdeiros
Sempre chame a implementação base. A falha ao fazer isso desabilitará significativamente todo o sistema de propriedades WPF, fazendo com que valores incorretos sejam relatados.