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

Définition

Crée une copie figée de Freezable à l'aide des valeurs de propriété actuelles.Creates a frozen copy of the Freezable using current property values. Étant donné que la copie est figée, tous les sous-objets figés sont copiés par référence.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

Retours

Copie figée de Freezable.A frozen copy of the Freezable. La propriété IsFrozen de la copie a la valeur true.The copy's IsFrozen property is set to true.

Remarques

L’utilisation de cette méthode est similaire à la création d' CloneCurrentValue une copie à l’aide de Freeze , puis à sa congélation avec la méthode.Using this method is similar to creating a copy using the CloneCurrentValue and then freezing it with the Freeze method.

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

Le tableau suivant résume les différences entre les GetAsFrozen méthodes et. GetCurrentValueAsFrozenThe following table summarizes the differences between the GetAsFrozen and GetCurrentValueAsFrozen methods.

ActionAction Comportement de la méthode GetAsFrozenGetAsFrozen method behavior Comportement de la méthode GetCurrentValueAsFrozenGetCurrentValueAsFrozen method behavior
Copie d’une propriété de dépendance qui a une expressionCopying a dependency property that has an expression La méthode lève une InvalidOperationException , car elle ne peut pas Freeze la propriété.The method throws an InvalidOperationException because it cannot Freeze the property. La valeur actuelle de l’expression est copiée, mais pas l’expression elle-même.The current value of the expression is copied, but not the expression itself.
Copie d’une propriété de dépendance animéeCopying an animated dependency property La valeur de base de la propriété (non animée) est copiée.The property's base (non-animated) value is copied. Les animations ne sont pas copiées.Animations are not copied. La valeur animée actuelle de la propriété est copiée.The property's current animated value is copied. Les animations ne sont pas copiées.Animations are not copied.

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.Note that unset properties are not copied, nor are read-only properties.

Pour créer une copie du Freezable qui n’est pas figé, utilisez la CloneCurrentValue méthode.To create a copy of the Freezable that is not frozen, use the CloneCurrentValue method.

Notes pour les héritiers

Cette méthode utilise la méthode GetCurrentValueAsFrozenCore(Freezable) virtuelle pour produire le clone.This method uses the virtual GetCurrentValueAsFrozenCore(Freezable) method to produce the clone.

S’applique à

Voir aussi