DesignerSerializationManager.PreserveNames 屬性

定義

命名空間:

System.ComponentModel.Design.Serialization

組件:

System.Windows.Forms.Design.dll

取得或設定值，指出是否 CreateInstance(Type, ICollection, String, Boolean) 方法應當檢查容器中指定名稱存在與否。

public:
 property bool PreserveNames { bool get(); void set(bool value); };

public bool PreserveNames { get; set; }

member this.PreserveNames : bool with get, set

Public Property PreserveNames As Boolean

屬性值

Boolean

如果 CreateInstance(Type, ICollection, String, Boolean) 傳遞指定的元件名稱，則為 true，如果 CreateInstance(Type, ICollection, String, Boolean) 檢查容器中是否存在指定名稱，則為 false。 預設為 true。

例外狀況

InvalidOperationException

這個屬性從序列化工作階段內變更。

備註

屬性 PreserveNames 會決定 方法的行為 CreateInstance 。 如果 true為 ， CreateInstance 則會傳遞指定的元件名稱。 如果 false為 ， CreateInstance 則會檢查容器中是否有指定名稱。 如果名稱不存在於容器中， CreateInstance 將會使用指定的名稱。 如果名稱存在於容器中， CreateInstance 則會在將它新增至容器時，將 Null 值當做元件的名稱傳遞，藉此提供新的名稱。 第二個變化適用於實作一律複製物件的串行化程式，而不是假設這些物件不存在。 貼上命令通常會使用這種類型的串行化程式。

當您不在串行化會話中時，您只能變更此屬性。

另請參閱

• DesignerSerializationManager
• CreateInstance(Type, ICollection, String, Boolean)