Freezable.GetAsFrozen Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows
Zestaw:
WindowsBase.dll

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.Freezable
Public Function GetAsFrozen () As Freezable

Zwraca

Freezable

Zamrożona kopia elementu Freezable. Właściwość kopiowania jest ustawiona IsFrozen na truewartość .

Wyjątki

InvalidOperationException

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.

Dotyczy

Zobacz też