FrameworkElement.OnPropertyChanged(DependencyPropertyChangedEventArgs) Metod

Definition

Anropas när det effektiva värdet för någon beroendeegenskap FrameworkElement har uppdaterats. Den specifika beroendeegenskap som ändrades rapporteras i argumentparametern. Åsidosätter 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)

Parametrar

e
DependencyPropertyChangedEventArgs

Händelsedata som beskriver egenskapen som ändrades, samt gamla och nya värden.

Kommentarer

Den här metoden är inte avsedd att i allmänhet identifiera egenskapsändringar eller ogiltigförklaringar. Den är i stället avsedd för ändringar av det allmänna ogiltighetsmönstret om viss information är känd om breda klassificeringar av egenskaper.

Den här metoden anropas potentiellt många gånger under ett objekts livslängd. Därför kan du uppnå bättre prestanda om du åsidosätter metadata för specifika egenskaper och sedan bifogar CoerceValueCallback eller PropertyChangedCallback funktioner för enskilda egenskaper. Du skulle dock använda den här metoden om en FrameworkElement innehåller ett stort antal värderelaterade beroendeegenskaper, eller om den innehåller logik, till exempel återgivningsbeteende som måste köras igen för flera relaterade fall av egenskapsfel.

Observera att det finns en identiskt namngiven OnPropertyChanged metod med en annan signatur (parametertypen är PropertyChangedEventArgs) som kan visas i ett antal klasser. Det OnPropertyChanged används för meddelanden om dataobjekt och ingår i kontraktet för INotifyPropertyChanged.

Anteckningar till arvingar

Anropa alltid basimplementeringen som den första åtgärden i implementeringen. Om du inte gör det inaktiveras hela WPF egenskapssystemet avsevärt, vilket gör att felaktiga värden rapporteras. Den specifika FrameworkElement implementeringen ansvarar också för att upprätthålla rätt tillstånd för en mängd olika egenskaper som påverkar det synliga användargränssnittet. Dessa inkluderar att ogiltigförklara det visuella trädet baserat på ändringar i formatmallen vid lämpliga tidpunkter.

Gäller för

Se även