Freezable.GetCurrentValueAsFrozen Метод

Определение

Создает фиксированную копию объекта Freezable с использованием текущих значений свойств.Creates a frozen copy of the Freezable using current property values. Так как копия является фиксированной, копируются только ссылки на фиксированные вложенные объекты.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

Возвраты

Фиксированная копия объекта Freezable.A frozen copy of the Freezable. Свойство копии IsFrozen имеет значение true.The copy's IsFrozen property is set to true.

Комментарии

Использование этого метода аналогично созданию копии с помощью CloneCurrentValue и последующей фиксации с помощью метода Freeze.Using this method is similar to creating a copy using the CloneCurrentValue and then freezing it with the Freeze method.

Методы GetAsFrozen и GetCurrentValueAsFrozen могут повысить производительность копирования, поскольку они не клонированы Freezable подобъектов, которые уже заморожены. они копируются только по ссылке.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.

В следующей таблице приведены различия между методами GetAsFrozen и GetCurrentValueAsFrozen.The following table summarizes the differences between the GetAsFrozen and GetCurrentValueAsFrozen methods.

ДействиеAction Поведение метода ЖетасфрозенGetAsFrozen method behavior Поведение метода ЖеткуррентвалуеасфрозенGetCurrentValueAsFrozen method behavior
Копирование свойства зависимостей, имеющего выражениеCopying a dependency property that has an expression Метод создает исключение InvalidOperationException, так как не может Freeze свойство.The method throws an InvalidOperationException because it cannot Freeze the property. Текущее значение выражения копируется, но не само выражение.The current value of the expression is copied, but not the expression itself.
Копирование анимированного свойства зависимостейCopying an animated dependency property Копируется базовое (не анимационное) значение свойства.The property's base (non-animated) value is copied. Анимации не копируются.Animations are not copied. Копируется текущее анимированное значение свойства.The property's current animated value is copied. Анимации не копируются.Animations are not copied.

Обратите внимание, что неопределенные свойства не копируются и не являются свойствами только для чтения.Note that unset properties are not copied, nor are read-only properties.

Чтобы создать копию незамороженного Freezable, используйте метод CloneCurrentValue.To create a copy of the Freezable that is not frozen, use the CloneCurrentValue method.

Примечания для тех, кто наследует этот метод

Этот метод использует метод Virtual GetCurrentValueAsFrozenCore(Freezable) для создания клона.This method uses the virtual GetCurrentValueAsFrozenCore(Freezable) method to produce the clone.

Применяется к

Дополнительно