Freezable.GetAsFrozen Método

Definição

Namespace:

System.Windows

Assembly:

WindowsBase.dll

Cria uma cópia congelada o Freezable usando valores de propriedade base (não animadas). Já que a cópia está congelada, quaisquer subobjetos congelados são copiados por referência.

public:
 System::Windows::Freezable ^ GetAsFrozen();

public System.Windows.Freezable GetAsFrozen ();

member this.GetAsFrozen : unit -> System.Windows.Freezable

Public Function GetAsFrozen () As Freezable

Retornos

Freezable

Uma cópia congelada do Freezable. A propriedade IsFrozen da cópia está definida para true.

Exceções

InvalidOperationException

O Freezable não pode ser congelado porque ele contém expressões ou propriedades animadas.

Comentários

Você deve verificar a CanFreeze propriedade antes de chamar esse método para verificar se ela Freezable pode ser congelada. O uso desse método é semelhante à criação de uma cópia usando o Clone método e, em seguida, congelando-o com o Freeze método.

Os GetAsFrozen métodos e os GetCurrentValueAsFrozen métodos podem melhorar o desempenho de cópia porque eles não clonam Freezable sub-objetos que já estão congelados; eles só os copiam por referência.

A tabela a seguir resume as diferenças entre os métodos e GetCurrentValueAsFrozen os GetAsFrozen métodos.

Ação	Comportamento do método GetAsFrozen	Comportamento do método GetCurrentValueAsFrozen
Copiando uma propriedade de dependência que tem uma expressão	O método gera um InvalidOperationException porque não pode Freeze a propriedade.	O valor atual da expressão é copiado, mas não a expressão em si.
Copiando uma propriedade de dependência animada	O valor base (não animado) da propriedade é copiado. As animações não são copiadas.	O valor animado atual da propriedade é copiado. As animações não são copiadas.

Observe que as propriedades não desajustadas não são copiadas nem são propriedades somente leitura.

Para criar uma cópia do Freezable que não está congelado, use o Clone método.

Notas aos Herdeiros

Esse método usa o método virtual GetAsFrozenCore(Freezable) para produzir o clone.

Confira também

• GetAsFrozenCore(Freezable)