Esta página foi útil?
Seus comentários sobre este conteúdo são importantes. Queremos saber sua opinião.
Comentários adicionais?
1500 caracteres restantes
Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

Método Freezable.CloneCurrentValueCore

Torna a instância um clone modificável (cópia em profundidade) do especificado Freezable usando valores de propriedade atual.

Namespace:  System.Windows
Assembly:  WindowsBase (em WindowsBase.dll)

protected virtual void CloneCurrentValueCore(
	Freezable sourceFreezable
)

Parâmetros

sourceFreezable
Tipo: System.Windows.Freezable
O Freezable a ser clonado.

Este método é chamado o CloneCurrentValue método e não deve ser chamado diretamente do seu código,, exceto ao chamar a implementação base ao substituir esse método. Para criar uma cópia modificável do objeto atual, chame CloneCurrentValue em vez de chamar esse método diretamente.

Observações para herdeiros

Se você derivar de Freezable, talvez você precise substituir esse método. Razões para substituir incluem o seguinte:

  • Sua classe derivada tem dados que não são expostos por meio de propriedades de dependência.

  • Sua classe derivada deve realizar o trabalho extra de inicialização que não pode ser realizado, simplesmente substituindo CreateInstanceCore. Por exemplo, isso se aplica se a sua classe derivada implementa ISupportInitialize.

Classes que armazenam todos os seus dados nas propriedades de dependência e que não é necessário realizar o trabalho extra de inicialização não é necessário substituir CloneCurrentValueCore.

É essencial que todas as implementações chamar a implementação base desse método. Implementações só devem executar o trabalho que não é realizado pela implementação padrão. A implementação padrão faz cópias profunda de todas as propriedades graváveis, definidas localmente. Se o objeto contém propriedades de dependência com expressões (como uma ligação de dados), o valor atual da expressão é copiado, mas não a expressão.

Se o objeto tem animado propriedades de dependência, o valor atual animado dessas propriedades é copiado, mas não são de animações.

Observe que remover propriedades não são copiadas, nem são propriedades somente leitura. Se essa propriedade tem um valor padrão que é um congelado Freezable, que o valor da propriedade permanece congelado em contrário modificável clone.

A lista a seguir resume o comportamento esperado para este método.

  • A cópia produzida contém cópias de todas as Freezable subobjetos.

  • Propriedades unset e somente leitura não são copiadas.

  • Se uma propriedade é animada, seu valor atual é copiado, mas a animação não é.

  • Nenhum dos seguintes subobjetos estão congelados na criação.

  • A cópia em si não é congelada.

.NET Framework

Com suporte em: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2015 Microsoft