Freezable.GetCurrentValueAsFrozen メソッド

定義

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

現在のプロパティ値を使用して、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されず、参照によってのみコピーされるため、コピーのパフォーマンスを向上させることができます。

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

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

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

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

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