DependencyObject.OnPropertyChanged(DependencyPropertyChangedEventArgs) Methode

Definitie

Aangeroepen wanneer de effectieve waarde van een afhankelijkheidseigenschap op deze DependencyObject eigenschap is bijgewerkt. De specifieke afhankelijkheidseigenschap die is gewijzigd, wordt gerapporteerd in de gebeurtenisgegevens.

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 -> unit
Protected Overridable Sub OnPropertyChanged (e As DependencyPropertyChangedEventArgs)

Parameters

e
DependencyPropertyChangedEventArgs

Gebeurtenisgegevens die de id van de afhankelijkheidseigenschap bevatten van belang, de metagegevens van de eigenschap voor het type en oude en nieuwe waarden.

Opmerkingen

Deze methode is niet bedoeld om in het algemeen afzonderlijke eigenschapswijzigingen te detecteren of ongeldige eigenschappen per geval uit te voeren. OnPropertyChanged is in plaats daarvan bedoeld voor wijzigingen van het algemene ongeldigheidspatroon, als bepaalde informatie bekend is over brede classificaties van eigenschappen. Wijzigingen in een Freezable kunnen bijvoorbeeld wijzigingen zijn in de waardetypen van de Freezable, of kunnen subproperties zijn, waarbij de wijzigingen zich in andere Freezable verwijzingen bevinden. De Freezable implementatie van onderdrukking maakt gebruik van OnPropertyChanged interne informatie om te bepalen of de eigenschappen subproperties zijn en biedt de juiste basisklasselogica voor beide gevallen.

OnPropertyChanged wordt mogelijk vaak aangeroepen tijdens het leven van een object. Daarom kunt u betere prestaties bereiken voor het algehele eigenschappensysteem als u de metagegevens van specifieke eigenschappen overschrijft en vervolgens koppelt CoerceValueCallback of PropertyChangedCallback functies voor afzonderlijke eigenschappen. U kunt deze methode echter gebruiken als een DependencyObject groot aantal waarde-gerelateerde afhankelijkheidseigenschappen bevat of als deze logica bevat, zoals renderinggedrag dat opnieuw moet worden uitgevoerd voor verschillende gerelateerde gevallen van ongeldige eigenschappen.

Notities voor overnemers

Roep altijd de basis-implementatie aan. Als u dit niet doet, wordt het hele WPF eigenschapssysteem aanzienlijk uitgeschakeld, waardoor onjuiste waarden worden gerapporteerd.

Van toepassing op

Zie ook