Freezable.IsFrozen Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets a value that indicates whether the object is currently modifiable.
public:
property bool IsFrozen { bool get(); };
public bool IsFrozen { get; }
member this.IsFrozen : bool
Public ReadOnly Property IsFrozen As Boolean
Property Value
true
if the object is frozen and cannot be modified; false
if the object can be modified.
Remarks
Attempting to modify an object when its IsFrozen property is true
throws an InvalidOperationException.
This property is read-only from the object model perspective. Some of the documentation about Freezable behaviors may mention "sets IsFrozen to true
" or similar language when discussing the behavior of other methods of Freezable, but this behavior is happening internally in the class instances, when methods of the instance manipulate the private variables that exist within the abstract class. To set the value of this property, you should call Freeze. This effectively is a one-time operation to change the IsFrozen property from the initial default false
state to the true
state. There is no available means to set the value back to false
. Instead, you could change any deep copy made from the original (see the Clone method). This is by design and is how any derived class should behave when applied to the cases where the Freezable pattern is useful.