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 CanFreeze propriété avant d’appeler cette méthode pour vérifier que le Freezable peut être figé. L’utilisation de cette méthode est similaire à la création d’une copie à l’aide de Clone , puis à sa congélation avec la Freeze méthode.

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

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

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 , 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 de la propriété (non animée) 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 du Freezable qui n’est pas figé, utilisez la Clone méthode.

Notes pour les héritiers

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

S’applique à

Voir aussi