DependencyObject.OnPropertyChanged(DependencyPropertyChangedEventArgs) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Invocado sempre que o valor efetivo de qualquer propriedade de dependência disto DependencyObject for atualizado. A propriedade específica da dependência que mudou é reportada 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 eventos que conterão o identificador de propriedade de dependência de interesse, os metadados da propriedade do tipo, e valores antigos e novos.
Observações
Este método não se destina geralmente a detetar alterações individuais de propriedades ou a realizar invalidações de propriedades caso a caso. OnPropertyChanged destina-se, em vez disso, a modificações do padrão geral de invalidação, se certa informação for conhecida sobre classificações amplas de propriedades. Por exemplo, alterações em a Freezable podem ser alterações nos tipos de valor do Freezable, ou podem ser subpropriedades, onde as alterações estão dentro de outras Freezable referências. A Freezable implementação de override OnPropertyChanged de utiliza informação interna para determinar se as propriedades são subpropriedades e fornece lógica de classe base apropriada para qualquer dos casos.
OnPropertyChanged é potencialmente invocado muitas vezes ao longo da vida de um objeto. Assim, pode obter melhor desempenho para o sistema de propriedades como um todo se sobrescrever os metadados de propriedades específicas e depois anexar CoerceValueCallback funções ou PropertyChangedCallback para propriedades individuais. No entanto, usaria este método se a DependencyObject incluir um número significativo de propriedades de dependência inter-relacionadas com valor, ou se incluir lógica como comportamento de renderização que deve ser repetido para vários casos relacionados de invalidação de propriedades.
Notas para Herdeiros
Chama sempre a implementação base. A falha em fazer isto irá desabilitar significativamente todo o sistema de propriedades WPF, causando a reportagem de valores incorretos.
