Partager via


Freezable.GetAsFrozen Méthode

Définition

Crée une copie figée de Freezable, à l'aide des valeurs de propriété (non-animées) de base. Étant donné que la copie est figée, tous les sous-objets figés sont copiés par référence.

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

Retours

Freezable

Copie figée de Freezable. La propriété IsFrozen de la copie a la valeur true.

Exceptions

Freezable ne peut pas être figé parce qu'il contient des expressions ou des propriétés animées.

Remarques

Vous devez vérifier la propriété avant d’appeler CanFreeze cette méthode pour vérifier que la Freezable valeur peut être figée. L’utilisation de cette méthode est similaire à la création d’une copie à l’aide de la méthode, puis à la Clone figer avec la Freeze méthode.

Les méthodes et GetCurrentValueAsFrozen les GetAsFrozen méthodes peuvent améliorer les performances de copie, car elles ne clonent Freezable pas de sous-objets déjà figés ; elles les copient uniquement par référence.

Le tableau suivant récapitule les différences entre les méthodes et GetCurrentValueAsFrozen les GetAsFrozen méthodes.

Action Comportement de la méthode GetAsFrozen Comportement de la méthode GetCurrentValueAsFrozen
Copie d’une propriété de dépendance qui a une expression La méthode lève une InvalidOperationException valeur, car elle ne peut pas Freeze la propriété. La valeur actuelle de l’expression est copiée, mais pas l’expression elle-même.
Copie d’une propriété de dépendance animée La valeur de base (non animée) de la propriété est copiée. Les animations ne sont pas copiées. La valeur animée actuelle de la propriété est copiée. Les animations ne sont pas copiées.

Notez que les propriétés non définies ne sont pas copiées et ne sont pas des propriétés en lecture seule.

Pour créer une copie de l’élément Freezable qui n’est pas figé, utilisez la Clone méthode.

Notes pour les héritiers

Cette méthode utilise la méthode virtuelle GetAsFrozenCore(Freezable) pour produire le clone.

S’applique à

Voir aussi