Freezable.GetAsFrozen Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Tworzy zamrożoną kopię Freezableobiektu przy użyciu wartości właściwości base (nie animowanych). Ponieważ kopia jest zamrożona, wszystkie zamrożone obiekty podrzędne są kopiowane przez odwołanie.
public:
System::Windows::Freezable ^ GetAsFrozen();public System.Windows.Freezable GetAsFrozen ();member this.GetAsFrozen : unit -> System.Windows.FreezablePublic Function GetAsFrozen () As FreezableZwraca
Zamrożona kopia elementu Freezable. Właściwość kopiowania jest ustawiona IsFrozen na truewartość .
Wyjątki
Freezable Nie można go zablokować, ponieważ zawiera wyrażenia lub animowane właściwości.
Uwagi
Przed wywołaniem tej metody należy sprawdzić właściwość, CanFreeze aby sprawdzić, czy Freezable można je zablokować. Użycie tej metody jest podobne do tworzenia kopii przy użyciu metody Clone , a następnie zamrażania jej za Freeze pomocą metody .
Metody GetAsFrozen i GetCurrentValueAsFrozen mogą poprawić wydajność kopiowania, ponieważ nie klonują Freezable już obiektów podrzędnych, które są już zamrożone; kopiują je tylko przy użyciu odwołania.
W poniższej tabeli przedstawiono podsumowanie różnic między GetAsFrozen metodami i GetCurrentValueAsFrozen .
| Akcja | Zachowanie metody GetAsFrozen | Zachowanie metody GetCurrentValueAsFrozen |
|---|---|---|
| Kopiowanie właściwości zależności, która ma wyrażenie | Metoda zgłasza obiekt , InvalidOperationException ponieważ nie może Freeze właściwości. | Bieżąca wartość wyrażenia jest kopiowana, ale nie sama wyrażenie. |
| Kopiowanie animowanej właściwości zależności | Wartość podstawowa właściwości (nie animowana) jest kopiowana. Animacje nie są kopiowane. | Bieżąca animowana wartość właściwości jest kopiowana. Animacje nie są kopiowane. |
Należy pamiętać, że nieskonfigurowane właściwości nie są kopiowane ani nie są właściwościami tylko do odczytu.
Aby utworzyć kopię Freezable obiektu, który nie jest zamrożony, użyj Clone metody .
Uwagi dotyczące dziedziczenia
Ta metoda używa metody wirtualnej GetAsFrozenCore(Freezable) do utworzenia klonu.
