Freezable.GetCurrentValueAsFrozen メソッド

定義

現在のプロパティ値を使用して、 Freezable の固定コピーを作成します。 コピーは固定されているため、固定されたサブオブジェクトは参照によってコピーされます。

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

返品

Freezableの固定されたコピー。 コピーの IsFrozen プロパティは true に設定されます。

注釈

このメソッドの使用は、 CloneCurrentValue を使用してコピーを作成し、 Freeze メソッドで固定するのと似ています。

GetAsFrozenメソッドと GetCurrentValueAsFrozen メソッドは、既に固定されているサブオブジェクトFreezable複製しないため、コピーのパフォーマンスを向上させることができます。これらは参照によってのみコピーします。

次の表は、 GetAsFrozen メソッドと GetCurrentValueAsFrozen メソッドの違いをまとめたものです。

アクション GetAsFrozen メソッドの動作 GetCurrentValueAsFrozen メソッドの動作
式を含む依存関係プロパティのコピー プロパティをInvalidOperationExceptionできないため、メソッドはFreezeをスローします。 式の現在の値はコピーされますが、式自体はコピーされません。
アニメーション化された依存関係プロパティのコピー プロパティの基本 (アニメーション化されていない) 値がコピーされます。 アニメーションはコピーされません。 プロパティの現在のアニメーション値がコピーされます。 アニメーションはコピーされません。

未設定のプロパティはコピーされず、読み取り専用プロパティでもありません。

固定されていない Freezable のコピーを作成するには、 CloneCurrentValue メソッドを使用します。

注意 (継承者)

このメソッドは、仮想 GetCurrentValueAsFrozenCore(Freezable) メソッドを使用して複製を生成します。

適用対象

こちらもご覧ください