Freezable.Freeze Freezable.Freeze Freezable.Freeze Freezable.Freeze Method

定義

Freezable 物件設為不可修改的再將它的 IsFrozen 屬性設定為 true,或者測試是否可以將 Freezable 物件設為不可修改的。Makes a Freezable object unmodifiable and sets its IsFrozen property to true, or tests whether a Freezable object can be made unmodifiable.

多載

Freeze() Freeze() Freeze() Freeze()

將目前的物件設為不可修改,並將其 IsFrozen 屬性設定為 trueMakes the current object unmodifiable and sets its IsFrozen property to true.

Freeze(Freezable, Boolean) Freeze(Freezable, Boolean) Freeze(Freezable, Boolean)

如果 isChecking 參數是 true,則這個方法表示是否可以將指定的 Freezable 設為不可修改的。If the isChecking parameter is true, this method indicates whether the specified Freezable can be made unmodifiable. 如果 isChecking 參數是 false,則這個方法會嘗試將指定的 Freezable 設為不可修改的,並表示作業是否成功。If the isChecking parameter is false, this method attempts to make the specified Freezable unmodifiable and indicates whether the operation succeeded.

Freeze() Freeze() Freeze() Freeze()

將目前的物件設為不可修改,並將其 IsFrozen 屬性設定為 trueMakes the current object unmodifiable and sets its IsFrozen property to true.

public:
 void Freeze();
public void Freeze ();
member this.Freeze : unit -> unit
Public Sub Freeze ()

例外狀況

備註

若要避免呼叫這個方法InvalidOperationException時的可能性, 請CanFreeze檢查Freezable屬性, 以判斷是否可以在呼叫這個方法之前, 將設為不可修改。To avoid the possibility of an InvalidOperationException when calling this method, check the CanFreeze property to determine whether the Freezable can be made unmodifiable before calling this method.

給繼承者的注意事項

這個方法會使用FreezeCore(Boolean)方法, Freezable讓無法修改。This method uses the FreezeCore(Boolean) method to make the Freezable unmodifiable. 若要修改凍結行為, 請FreezeCore(Boolean)覆寫方法。To modify freezing behavior, override the FreezeCore(Boolean) method.

另請參閱

Freeze(Freezable, Boolean) Freeze(Freezable, Boolean) Freeze(Freezable, Boolean)

如果 isChecking 參數是 true,則這個方法表示是否可以將指定的 Freezable 設為不可修改的。If the isChecking parameter is true, this method indicates whether the specified Freezable can be made unmodifiable. 如果 isChecking 參數是 false,則這個方法會嘗試將指定的 Freezable 設為不可修改的,並表示作業是否成功。If the isChecking parameter is false, this method attempts to make the specified Freezable unmodifiable and indicates whether the operation succeeded.

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

參數

freezable
Freezable Freezable Freezable Freezable

要檢查或設為不可修改的物件。The object to check or make unmodifiable. 如果 isCheckingtrue,則會檢查物件,判斷是否可以將它設為不可修改的。If isChecking is true, the object is checked to determine whether it can be made unmodifiable. 如果 isCheckingfalse,則會適時將物件設為不可修改的。If isChecking is false, the object is made unmodifiable, if possible.

isChecking
Boolean Boolean Boolean Boolean

true 表示傳回是否可以凍結物件 (而不是實際進行凍結),false 則表示實際凍結物件。true to return an indication of whether the object can be frozen (without actually freezing it); false to actually freeze the object.

傳回

如果 isCheckingtrue,則這個方法會在可以將指定的 Freezable 設為不可修改的時傳回 true,並在無法設為不可修改的時傳回 falseIf isChecking is true, this method returns true if the specified Freezable can be made unmodifiable, or false if it cannot be made unmodifiable. 如果 isCheckingfalse,則這個方法會在指定的 Freezable 現在為不可修改的時傳回 true,並在無法設為不可修改的時傳回 falseIf isChecking is false, this method returns true if the specified Freezable is now unmodifiable, or false if it cannot be made unmodifiable.

例外狀況

isCheckingfalse 時,將 freezable 設為不可修改的嘗試失敗了。這個物件現在是處於未知的狀態 (可能是局部凍結)。When isChecking is false, the attempt to make freezable unmodifiable was unsuccessful; the object is now in an unknown state (it might be partially frozen).

備註

除非您是從Freezable衍生並覆FreezeCore寫方法, 否則請不要呼叫此方法。Do not call this method unless you are deriving from Freezable and overriding the FreezeCore method. 這個方法可用於FreezeCore方法中, 以凍結本身Freezable為物件的類別資料成員。This method may be used in the FreezeCore method to freeze class data members that are themselves Freezable objects.

可以在已凍結 (無法修改) 的Freezable物件上, 再次呼叫此方法。It is alright to call this method again on a Freezable object that is already frozen (unmodifiable).

給繼承者的注意事項

這個方法會使用FreezeCore(Boolean)方法, Freezable讓無法修改。This method uses the FreezeCore(Boolean) method to make the Freezable unmodifiable. 若要修改凍結行為, 請FreezeCore(Boolean)覆寫方法。To modify freezing behavior, override the FreezeCore(Boolean) method.

另請參閱

適用於