Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Freezable.GetAsFrozenCore Method

Makes this instance a frozen clone of the specified Freezable using base (non-animated) property values.

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

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

Parameters

sourceFreezable

The instance to copy.

This method is called by GetAsFrozen. 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 GetAsFrozen 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 GetAsFrozenCore. 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 makes deep copies of any unfrozen freezables and shallow copies of all other writable, locally set properties it contains. If this object has data bound dependency properties, the expressions 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 base (non-animated) values of those properties is copied. Animations are not copied. Note that unset properties are not copied, nor are read-only properties. 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
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

Show:
© 2014 Microsoft