Freezable.GetAsFrozen Freezable.GetAsFrozen Freezable.GetAsFrozen Freezable.GetAsFrozen Method

정의

고정 된 복사본을 만들고는 Freezable, 기본 (애니메이션이 적용 되지 않은) 속성 값을 사용 하 여 합니다.Creates a frozen copy of the Freezable, using base (non-animated) property values. 복사본이 고정 되어 있으므로 모든 고정 된 하위 개체는 참조로 복사 됩니다.Because the copy is frozen, any frozen sub-objects are copied by reference.

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

반환

고정 된 복사본을 Freezable입니다.A frozen copy of the Freezable. 복사본의 IsFrozen 속성이 true합니다.The copy's IsFrozen property is set to true.

예외

Freezable 식 또는 애니메이션이 적용 된 속성이 있기 때문에 고정할 수 없습니다.The Freezable cannot be frozen because it contains expressions or animated properties.

설명

확인 해야 합니다 CanFreeze 되어 있는지 확인 하려면이 메서드를 호출 하기 전에 속성은 Freezable 고정할 수 있습니다.You should check the CanFreeze property before calling this method to verify that the Freezable can be frozen. 이 메서드를 사용 하는 것은 사용 하 여 복사본을 만드는 것과 유사 합니다 Clone 한 다음 사용 하 여 고정 및를 Freeze 메서드.Using this method is similar to creating a copy using the Clone 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.

다음 표에서 간의 차이점을 요약 합니다 GetAsFrozenGetCurrentValueAsFrozen 메서드.The following table summarizes the differences between the GetAsFrozen and GetCurrentValueAsFrozen methods.

작업Action GetAsFrozen 메서드 동작GetAsFrozen method behavior GetCurrentValueAsFrozen 메서드 동작GetCurrentValueAsFrozen method behavior
식이 포함 된 종속성 속성 복사Copying a dependency property that has an expression 메서드에서 throw 한 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 즉 고정된 되지를 사용 하 여는 Clone 메서드.To create a copy of the Freezable that is not frozen, use the Clone method.

상속자 참고

이 메서드를 사용 하 여 가상 GetAsFrozenCore(Freezable) 메서드 복제본을 만듭니다.This method uses the virtual GetAsFrozenCore(Freezable) method to produce the clone.

적용 대상

추가 정보