Freezable.Freeze 方法

定義

命名空間:

System.Windows

組件:

WindowsBase.dll

將 Freezable 物件設為不可修改的再將它的 IsFrozen 屬性設定為 true，或者測試是否可以將 Freezable 物件設為不可修改的。

多載

Freeze()	將目前的物件設為不可修改，並將其 IsFrozen 屬性設定為 true。
Freeze(Freezable, Boolean)	如果 isChecking 參數是 true，則這個方法表示是否可以將指定的 Freezable 設為不可修改的。 如果 isChecking 參數是 false，則這個方法會嘗試將指定的 Freezable 設為不可修改的，並表示作業是否成功。

Freeze()

將目前的物件設為不可修改，並將其 IsFrozen 屬性設定為 true。

public:
 void Freeze();

public void Freeze ();

member this.Freeze : unit -> unit

Public Sub Freeze ()

例外狀況

InvalidOperationException

無法將 Freezable 設為不可修改。

備註

若要避免在呼叫這個方法時發生的可能性 InvalidOperationException ，請檢查 CanFreeze 屬性，以判斷 是否可以 Freezable 在呼叫這個方法之前變成不可修改。

給繼承者的注意事項

這個方法會 FreezeCore(Boolean) 使用 方法來使 Freezable 不可修改。 若要修改凍結行為，請覆寫 FreezeCore(Boolean) 方法。

另請參閱

• FreezeCore(Boolean)

Freeze(Freezable, Boolean)

如果 isChecking 參數是 true，則這個方法表示是否可以將指定的 Freezable 設為不可修改的。 如果 isChecking 參數是 false，則這個方法會嘗試將指定的 Freezable 設為不可修改的，並表示作業是否成功。

protected public:
 static bool Freeze(System::Windows::Freezable ^ freezable, bool isChecking);

protected internal static bool Freeze (System.Windows.Freezable freezable, bool isChecking);

static member Freeze : System.Windows.Freezable * bool -> bool

Protected Friend Shared Function Freeze (freezable As Freezable, isChecking As Boolean) As Boolean

參數

freezable

Freezable

要檢查或設為不可修改的物件。 如果 isChecking 是 true，則會檢查物件，判斷是否可以將它設為不可修改的。 如果 isChecking 是 false，則會適時將物件設為不可修改的。

isChecking

Boolean

true 表示傳回是否可以凍結物件 (而不是實際進行凍結)，false 則表示實際凍結物件。

傳回

Boolean

如果 isChecking 是 true，則這個方法會在可以將指定的 Freezable 設為不可修改的時傳回 true，並在無法設為不可修改的時傳回 false。 如果 isChecking 是 false，則這個方法會在指定的 Freezable 現在為不可修改的時傳回 true，並在無法設為不可修改的時傳回 false。

例外狀況

InvalidOperationException

當 isChecking 是 false 時，將 freezable 設為不可修改的嘗試失敗了。這個物件現在是處於未知的狀態 (可能是局部凍結)。

備註

除非您衍生自 Freezable 並覆 FreezeCore 寫 方法，否則請勿呼叫此方法。 這個方法可用於 方法， FreezeCore 以凍結屬於 Freezable 物件本身的類別資料成員。

在已凍結 (不可修改) 的物件上 Freezable 再次呼叫此方法是沒錯的。

給繼承者的注意事項

這個方法會 FreezeCore(Boolean) 使用 方法來使 Freezable 不可修改。 若要修改凍結行為，請覆寫 FreezeCore(Boolean) 方法。

另請參閱

• FreezeCore(Boolean)