Freezable.GetCurrentValueAsFrozen 方法

定義

用目前屬性值建立一個凍結的副本 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這些 and GetCurrentValueAsFrozen 方法能提升複製效能,因為它們不會複製Freezable已經凍結的子物件;它們只是透過參考來複製。

下表總結了與GetAsFrozen方法之間的GetCurrentValueAsFrozen差異。

Action GetAsFrozen 方法的行為 GetCurrentValueAsFrozen 方法行為
複製具有表達式的依賴性質 這個方法拋出 , InvalidOperationException 因為它無法 Freeze 該屬性。 目前的運算式值會被複製,但不會複製表達式本身。
複製動畫依賴屬性 屬性的基礎值(非動畫值)會被複製。 動畫不會被複製。 屬性目前的動畫值會被複製。 動畫不會被複製。

請注意,未設定屬性不會被複製,唯讀屬性也不會被複製。

要建立未被凍結的 Freezable 副本,請使用該 CloneCurrentValue 方法。

給繼承者的注意事項

此方法使用虛擬 GetCurrentValueAsFrozenCore(Freezable) 方法來產生複製品。

適用於

另請參閱