次の方法で共有


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

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

注釈

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

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

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

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

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

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

注意 (継承者)

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

適用対象

こちらもご覧ください