FrameworkContentElement.OnPropertyChanged Método

Referência

Definição

Namespace:: System.Windows

Assembly:: PresentationFramework.dll

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 nesse FrameworkContentElement for atualizado. A propriedade de dependência específica alterada é relatada no parâmetro de argumentos. Substitui OnPropertyChanged(DependencyPropertyChangedEventArgs).

protected:
 override void OnPropertyChanged(System::Windows::DependencyPropertyChangedEventArgs e);

protected override void OnPropertyChanged (System.Windows.DependencyPropertyChangedEventArgs e);

override this.OnPropertyChanged : System.Windows.DependencyPropertyChangedEventArgs -> unit

Protected Overrides Sub OnPropertyChanged (e As DependencyPropertyChangedEventArgs)

Parâmetros

e: DependencyPropertyChangedEventArgs

Os dados de evento que descrevem a propriedade alterada, incluindo os valores novos e antigos.

Comentários

Esse método não se destina a detectar geralmente alterações de propriedade ou invalidações. 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.

Esse método é potencialmente invocado muitas vezes durante a vida útil de um objeto. Portanto, você poderá obter melhor desempenho se substituir os metadados de propriedades específicas e anexar CoerceValueCallback ou PropertyChangedCallback funções para propriedades individuais. No entanto, você usaria esse método se um FrameworkContentElement número significativo de propriedades de dependência interrelacionadas por valor ou se ele inclua lógica, como comportamento de renderização que deve ser executado novamente para vários casos relacionados de invalidações de propriedade.

Observe que há um método nomeado OnPropertyChanged de forma idêntica com uma assinatura diferente (o tipo de parâmetro é PropertyChangedEventArgs) que pode aparecer em várias classes. Isso OnPropertyChanged é usado para notificações de objeto de dados e faz parte do contrato para INotifyPropertyChanged.

Notas aos Herdeiros

Sempre chame a implementação base, como a primeira operação em sua implementação. A falha em fazer isso desabilitará significativamente todo o sistema de propriedades WPF, o que faz com que valores incorretos sejam relatados.

Aplica-se a