Freezable.GetCurrentValueAsFrozen メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
現在のプロパティ値を使用して、Freezable の固定されたコピーを作成します。 コピーが固定されているため、参照によって任意の固定されたサブオブジェクトがコピーされます。
public:
System::Windows::Freezable ^ GetCurrentValueAsFrozen();public System.Windows.Freezable GetCurrentValueAsFrozen ();member this.GetCurrentValueAsFrozen : unit -> System.Windows.FreezablePublic Function GetCurrentValueAsFrozen () As Freezable戻り値
Freezable の固定されたコピー。 コピーの IsFrozen プロパティは、true に設定されます。
注釈
このメソッドの使用は、コピーを作成してから CloneCurrentValue メソッドで Freeze 固定するのと似ています。
またGetAsFrozenGetCurrentValueAsFrozen、メソッドを使用すると、既に固定されているサブオブジェクトは複製Freezableされず、参照によってのみコピーされるため、コピーのパフォーマンスを向上させることができます。
次の表は、メソッドとGetCurrentValueAsFrozenメソッドの違いをGetAsFrozenまとめたものです。
| 操作 | GetAsFrozen メソッドの動作 | GetCurrentValueAsFrozen メソッドの動作 |
|---|---|---|
| 式を持つ依存関係プロパティのコピー | このメソッドは、プロパティを実行できないためFreeze、an InvalidOperationException をスローします。 | 式の現在の値はコピーされますが、式自体はコピーされません。 |
| アニメーション化された依存関係プロパティのコピー | プロパティの基本 (アニメーション化されていない) 値がコピーされます。 アニメーションはコピーされません。 | プロパティの現在のアニメーション化された値がコピーされます。 アニメーションはコピーされません。 |
未設定のプロパティはコピーされず、読み取り専用プロパティでもありません。
固定されていないコピーを Freezable 作成するには、メソッドを使用します CloneCurrentValue 。
注意 (継承者)
このメソッドは、仮想 GetCurrentValueAsFrozenCore(Freezable) メソッドを使用して複製を生成します。