FrameworkElement.OnPropertyChanged(DependencyPropertyChangedEventArgs) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
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
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.