DependencyObject.SetCurrentValue Method (DependencyProperty, Object) (System.Windows)

DependencyObjectSetCurrentValue Method

Note
The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Sets the value of a dependency property without changing its value source.

Namespace: System.Windows
Assembly: WindowsBase (in WindowsBase.dll)

Syntax

public void SetCurrentValue(
	DependencyProperty dp,
	object value
)

public:
void SetCurrentValue(
	DependencyProperty^ dp,
	Object^ value
)

member SetCurrentValue : 
        dp:DependencyProperty *
        value:Object -> unit

Public Sub SetCurrentValue (
	dp As DependencyProperty,
	value As Object
)

Parameters

dp: Type:
The identifier of the dependency property to set.

value: Type:
The new local value.

Exceptions

Exception	Condition
InvalidOperationException	Attempted to modify a read-only dependency property, or a property on a sealed DependencyObject.
ArgumentException	value was not the correct type as registered for the dp property.

Remarks

This method is used by a component that programmatically sets the value of one of its own properties without disabling an application's declared use of the property. The SetCurrentValue method changes the effective value of the property, but existing triggers, data bindings, and styles will continue to work.

Version Information

.NET Framework
Available since 4.0