Freezable.GetCurrentValueAsFrozen Freezable.GetCurrentValueAsFrozen Freezable.GetCurrentValueAsFrozen Freezable.GetCurrentValueAsFrozen Method

Definição

Cria uma cópia congelada do Freezable usando valores de propriedade atuais.Creates a frozen copy of the Freezable using current property values. Já que a cópia está congelada, quaisquer subobjetos congelados são copiados por referência.Because the copy is frozen, any frozen sub-objects are copied by reference.

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

Retornos

Uma cópia congelada do Freezable.A frozen copy of the Freezable. A propriedade IsFrozen da cópia está definida para true.The copy's IsFrozen property is set to true.

Comentários

Usar esse método é semelhante a criar uma cópia usando o CloneCurrentValue e, em seguida, congelando-o com o Freeze método.Using this method is similar to creating a copy using the CloneCurrentValue and then freezing it with the Freeze method.

Os GetAsFrozen métodos GetCurrentValueAsFrozen e podem melhorar o desempenho da cópia porque eles não Freezable clonam subobjetos que já estão congelados; eles apenas os copiam por referência.The GetAsFrozen and GetCurrentValueAsFrozen methods can improve copying performance because they do not clone Freezable sub-objects that are already frozen; they only copy them by reference.

A tabela a seguir resume as diferenças entre os GetAsFrozen métodos GetCurrentValueAsFrozen e.The following table summarizes the differences between the GetAsFrozen and GetCurrentValueAsFrozen methods.

AçãoAction Comportamento do método GetAsFrozenGetAsFrozen method behavior Comportamento do método GetCurrentValueAsFrozenGetCurrentValueAsFrozen method behavior
Copiando uma propriedade de dependência que tem uma expressãoCopying a dependency property that has an expression O método gera um InvalidOperationException porque ele não Freeze pode a propriedade.The method throws an InvalidOperationException because it cannot Freeze the property. O valor atual da expressão é copiado, mas não a própria expressão.The current value of the expression is copied, but not the expression itself.
Copiando uma propriedade de dependência animadaCopying an animated dependency property O valor base (não animado) da propriedade é copiado.The property's base (non-animated) value is copied. As animações não são copiadas.Animations are not copied. O valor animado atual da propriedade é copiado.The property's current animated value is copied. As animações não são copiadas.Animations are not copied.

Observe que as propriedades de desdefinição não são copiadas nem propriedades somente leitura.Note that unset properties are not copied, nor are read-only properties.

Para criar uma cópia do Freezable que não está congelado, use o CloneCurrentValue método.To create a copy of the Freezable that is not frozen, use the CloneCurrentValue method.

Notas aos Herdeiros

Esse método usa o método GetCurrentValueAsFrozenCore(Freezable) virtual para produzir o clone.This method uses the virtual GetCurrentValueAsFrozenCore(Freezable) method to produce the clone.

Aplica-se a

Veja também