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.

GetAsFrozenGetCurrentValueAsFrozenためそれらは複製しないでください、メソッドのコピーのパフォーマンスが向上する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 メソッドをスローする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.

適用対象

こちらもご覧ください