Freezable.GetCurrentValueAsFrozen Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Cria uma cópia congelada do Freezable uso de valores de propriedade atuais. Como a cópia está congelada, todos os sub-objetos 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
Uma cópia congelada do Freezable. A propriedade da IsFrozen cópia está definida como true.
Comentários
Usar esse método é semelhante à criação de uma cópia usando e CloneCurrentValue , em seguida, congelá-la com o Freeze método.
Os métodos e os GetAsFrozenGetCurrentValueAsFrozen 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 GetAsFrozen os GetCurrentValueAsFrozen 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 lança 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 da propriedade (não animado) é 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 unset 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.