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)