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複製しないため、コピーのパフォーマンスを向上させることができます。これらは参照によってのみコピーします。
次の表は、 GetAsFrozen メソッドと GetCurrentValueAsFrozen メソッドの違いをまとめたものです。
| アクション | GetAsFrozen メソッドの動作 | GetCurrentValueAsFrozen メソッドの動作 |
|---|---|---|
| 式を含む依存関係プロパティのコピー | プロパティをInvalidOperationExceptionできないため、メソッドはFreezeをスローします。 | 式の現在の値はコピーされますが、式自体はコピーされません。 |
| アニメーション化された依存関係プロパティのコピー | プロパティの基本 (アニメーション化されていない) 値がコピーされます。 アニメーションはコピーされません。 | プロパティの現在のアニメーション値がコピーされます。 アニメーションはコピーされません。 |
未設定のプロパティはコピーされず、読み取り専用プロパティでもありません。
固定されていない Freezable のコピーを作成するには、 CloneCurrentValue メソッドを使用します。
注意 (継承者)
このメソッドは、仮想 GetCurrentValueAsFrozenCore(Freezable) メソッドを使用して複製を生成します。