This documentation is archived and is not being maintained.

Freezable.GetCurrentValueAsFrozenCore Method

Makes this instance a frozen clone of the specified Freezable. If this object has animated dependency properties, their current animated values are copied.

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

protected virtual void GetCurrentValueAsFrozenCore (
	Freezable sourceFreezable
)
protected void GetCurrentValueAsFrozenCore (
	Freezable sourceFreezable
)
protected function GetCurrentValueAsFrozenCore (
	sourceFreezable : Freezable
)
You cannot use methods in XAML.

Parameters

sourceFreezable

The Freezable to copy and freeze.

This method is called by GetCurrentValueAsFrozen. and should not be called directly from your code, except when calling the base implementation while overriding this method. To create a frozen copy of the current object, call GetCurrentValueAsFrozen instead of calling this method directly.

Notes to Implementers: If you derive from Freezable you may need to override this method. Reasons to override include:

  • Your subclass has data that is not exposed via dependency properties.

  • Your subclass must perform extra initialization work that cannot be accomplished by simply overriding CreateInstanceCore. For example, if your subclass implements ISupportInitialize.

Classes that store all their data in dependency properties and that don't need to perform extra initialization work do not need to override GetCurrentValueAsFrozenCore. It is essential that all implementations call the base implementation of this method. Implementations should only perform work that is not performed by the default implementation. The default implementation creates a new Freezable using the CreateInstance method and makes deep copies of unfrozen freezables and shallow copies of all other writable, locally set properties it contains. If this object has data bound dependency properties, the data bindings are copied but might no longer resolve; for more information about cloning data bound objects, see the Freezable Objects Overview. If this object has animated dependency properties, the current animated value of those properties is copied, but the animations are not. Read-only dependency properties within a Freezable are not copied by this default implementation. If you do override this method, you must call the base implementation. You do not need to Freeze values as they are copied. The result will be frozen by GetAsFrozen before being returned.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0
Show: