Freezable.GetAsFrozen Freezable.GetAsFrozen Freezable.GetAsFrozen Freezable.GetAsFrozen Method

Definition

Erstellt eine fixierte Kopie von der Freezable, mit Basiseigenschaftswerten (nicht animiert).Creates a frozen copy of the Freezable, using base (non-animated) property values. Da die Kopie fixiert ist, werden alle fixierten Unterobjekte als Verweis kopiert.Because the copy is frozen, any frozen sub-objects are copied by reference.

public:
 System::Windows::Freezable ^ GetAsFrozen();
public System.Windows.Freezable GetAsFrozen ();
member this.GetAsFrozen : unit -> System.Windows.Freezable
Public Function GetAsFrozen () As Freezable

Gibt zurück

Eine fixierte Kopie von der Freezable.A frozen copy of the Freezable. Der Kopiervorgangs des IsFrozen -Eigenschaftensatz auf true.The copy's IsFrozen property is set to true.

Ausnahmen

Die Freezable kann nicht fixiert werden, da er Ausdrücke oder animierte Eigenschaften enthält.The Freezable cannot be frozen because it contains expressions or animated properties.

Hinweise

Überprüfen Sie die CanFreeze -Eigenschaft vor dem Aufrufen dieser Methode, um sicherzustellen, dass die Freezable kann fixiert werden.You should check the CanFreeze property before calling this method to verify that the Freezable can be frozen. Mit dieser Methode ähnelt der beim Erstellen einer Kopie mithilfe der Clone und dem anschließenden mit Fixieren der Freeze Methode.Using this method is similar to creating a copy using the Clone and then freezing it with the Freeze method.

Die GetAsFrozen und GetCurrentValueAsFrozen Methoden können die kopieren-Leistung verbessern, da sie nicht Klonen Freezable untergeordnete Objekte, die bereits eingefroren werden; sie nur kopieren Sie sie als Verweis.The GetAsFrozen and GetCurrentValueAsFrozen methods can improve copying performance because they do not clone Freezable sub-objects that are already frozen; they only copy them by reference.

In der folgende Tabelle werden die Unterschiede zwischen der GetAsFrozen und GetCurrentValueAsFrozen Methoden.The following table summarizes the differences between the GetAsFrozen and GetCurrentValueAsFrozen methods.

AktionAction Verhalten der GetAsFrozen-MethodeGetAsFrozen method behavior Verhalten der GetCurrentValueAsFrozen-MethodeGetCurrentValueAsFrozen method behavior
Kopieren einer Abhängigkeitseigenschaft, die einen Ausdruck verfügt.Copying a dependency property that has an expression Löst die Methode eine InvalidOperationException , da dies nicht möglich Freeze die-Eigenschaft.The method throws an InvalidOperationException because it cannot Freeze the property. Der aktuelle Wert des Ausdrucks wird jedoch nicht den Ausdruck selbst kopiert.The current value of the expression is copied, but not the expression itself.
Kopieren einer animierten AbhängigkeitseigenschaftCopying an animated dependency property Kopiert den Wert der Eigenschaft Basis (nicht animiert).The property's base (non-animated) value is copied. Animationen werden nicht kopiert.Animations are not copied. Der Eigenschaft aktuelle animierte Wert wird kopiert.The property's current animated value is copied. Animationen werden nicht kopiert.Animations are not copied.

Beachten Sie, dass nicht festgelegte Eigenschaften nicht kopiert werden oder sind schreibgeschützte Eigenschaften.Note that unset properties are not copied, nor are read-only properties.

Erstellen Sie eine Kopie der Freezable , nicht fixiert ist, verwenden die Clone Methode.To create a copy of the Freezable that is not frozen, use the Clone method.

Hinweise für Vererber

Diese Methode verwendet die virtuelle GetAsFrozenCore(Freezable) Methode, um den Klon zu erstellen.This method uses the virtual GetAsFrozenCore(Freezable) method to produce the clone.

Gilt für:

Siehe auch