Partilhar via


Freezable.GetCurrentValueAsFrozen Método

Definição

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

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

Retornos

Freezable

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

Comentários

O uso desse método é semelhante à criação de uma cópia usando o CloneCurrentValue 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 CloneCurrentValue método.

Notas aos Herdeiros

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

Aplica-se a

Confira também