Freezable.GetAsFrozen メソッド

定義

重要

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

基本プロパティ値 (アニメーション化されていない値) を使用して、Freezable の固定されたコピーを作成します。コピーが固定されているため、参照によって任意の固定されたサブオブジェクトがコピーされます。

public:
 System::Windows::Freezable ^ GetAsFrozen();

public System.Windows.Freezable GetAsFrozen ();

member this.GetAsFrozen : unit -> System.Windows.Freezable

Public Function GetAsFrozen () As Freezable

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

Freezable は、式またはアニメーション化されたプロパティを格納していないため、固定できません。

このメソッドを呼び出す前に CanFreeze 、プロパティを確認して、を Freezable 固定できることを確認する必要があります。このメソッドの使用は、を使用して Clone コピーを作成し、メソッドで Freeze 固定するのと似ています。

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

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

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

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

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

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