What Are the Key Methods of DependencyObject in WPF?

DependencyObject

The DependencyObject class in WPF (Windows Presentation Foundation) is the base class that enables objects to use the dependency property system, which is a core feature of WPF. It provides the base implementation for objects that have dependency properties, which are properties that can be set through methods such as data binding, styles, animations, and inheritance. 

Here are the key methods provided by the DependencyObject class:

1. GetValue(DependencyProperty dp) : Retrieves the current effective value of a dependency property on this DependencyObject.

Example:

var value = myDependencyObject.GetValue(MyProperty);

2. SetValue(DependencyProperty dp, object value): Sets the local value of a dependency property on this DependencyObject.

Example:

myDependencyObject.SetValue(MyProperty, newValue);

3. ClearValue(DependencyProperty dp): Clears the local value of a dependency property, causing the property to revert to its default value, inherited value, or any other applicable value as determined by WPF's property system.

Example:

myDependencyObject.ClearValue(MyProperty);

4. ReadLocalValue(DependencyProperty dp): Returns the local value of a dependency property, if it exists. If a local value is not set, this method returns DependencyProperty.UnsetValue.

Example:

var localValue = myDependencyObject.ReadLocalValue(MyProperty);

5. CoerceValue(DependencyProperty dp): Forces a re-evaluation of the specified dependency property's value by invoking the property's CoerceValueCallback, if it exists.

Example:

myDependencyObject.CoerceValue(MyProperty);

6. OnPropertyChanged(DependencyPropertyChangedEventArgs e): Called whenever the effective value of any dependency property on this DependencyObject has been updated. This is typically overridden in derived classes to respond to property changes.

Example:

protected override void OnPropertyChanged(DependencyPropertyChangedEventArgs e)

{

    base.OnPropertyChanged(e);

    // Custom logic here

}

7. SetCurrentValue(DependencyProperty dp, object value): Sets the value of a dependency property without changing its value source. This method is useful in scenarios where you want to update a property's value without altering its data binding or resource reference.

Example:

myDependencyObject.SetCurrentValue(MyProperty, newValue);

8. VerifyAccess(): Enforces that the calling thread has access to this DependencyObject. This method throws an InvalidOperationException if the calling thread is not the thread that created the DependencyObject.

Example:

myDependencyObject.VerifyAccess();

9. CheckAccess(): Determines whether the calling thread has access to this DependencyObject. Unlike VerifyAccess(), this method returns a boolean value instead of throwing an exception.

Example:

bool hasAccess = myDependencyObject.CheckAccess();