次の方法で共有


Freezable.GetAsFrozen メソッド

定義

基本プロパティ値 (アニメーション化されていない値) を使用して、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) メソッドを使用して複製を生成します。

適用対象

こちらもご覧ください