Freezable.GetAsFrozen Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Erstellt eine fixierte Kopie von Freezable mit Basiseigenschaftswerten (nicht animiert). Da die Kopie fixiert ist, werden alle fixierten Unterobjekte als Verweis kopiert.
public:
System::Windows::Freezable ^ GetAsFrozen();public System.Windows.Freezable GetAsFrozen ();member this.GetAsFrozen : unit -> System.Windows.FreezablePublic Function GetAsFrozen () As FreezableGibt zurück
Eine fixierte Kopie von Freezable. Die IsFrozen-Eigenschaft der Kopie ist auf true festgelegt.
Ausnahmen
Freezable kann nicht fixiert werden, da er Ausdrücke oder animierte Eigenschaften enthält.
Hinweise
Sie sollten die CanFreeze -Eigenschaft überprüfen, bevor Sie diese Methode aufrufen, um sicherzustellen, dass die Freezable eingefroren werden kann. Die Verwendung dieser Methode ähnelt dem Erstellen einer Kopie mit dem Clone und dem anschließenden Einfrieren mit der Freeze -Methode.
Die GetAsFrozen Methoden und GetCurrentValueAsFrozen können die Kopierleistung verbessern, da sie nicht bereits fixierte Unterobjekte klonen Freezable , sie nur nach Verweis kopieren.
In der folgenden Tabelle sind die Unterschiede zwischen den GetAsFrozen Methoden und GetCurrentValueAsFrozen zusammengefasst.
| Aktion | Verhalten der GetAsFrozen-Methode | Verhalten der GetCurrentValueAsFrozen-Methode |
|---|---|---|
| Kopieren einer Abhängigkeitseigenschaft mit einem Ausdruck | Die -Methode löst eine aus InvalidOperationException , da die -Eigenschaft nicht Freeze vorhanden ist. | Der aktuelle Wert des Ausdrucks wird kopiert, aber nicht der Ausdruck selbst. |
| Kopieren einer animierten Abhängigkeitseigenschaft | Der (nicht animierte) Basiswert der Eigenschaft wird kopiert. Animationen werden nicht kopiert. | Der aktuelle animierte Wert der Eigenschaft wird kopiert. Animationen werden nicht kopiert. |
Beachten Sie, dass nicht festgelegte Eigenschaften weder kopiert werden noch schreibgeschützte Eigenschaften sind.
Verwenden Sie die -Methode, um eine Kopie des zu erstellen, die FreezableClone nicht fixiert ist.
Hinweise für Vererber
Diese Methode verwendet die virtuelle GetAsFrozenCore(Freezable) Methode, um den Klon zu erzeugen.
