PersonalizationDictionary.Add(String, PersonalizationEntry) 方法

定義

命名空間:

System.Web.UI.WebControls.WebParts

組件:

System.Web.dll

將個人化項目加入個人化字典。

public:
 virtual void Add(System::String ^ key, System::Web::UI::WebControls::WebParts::PersonalizationEntry ^ value);

public virtual void Add (string key, System.Web.UI.WebControls.WebParts.PersonalizationEntry value);

abstract member Add : string * System.Web.UI.WebControls.WebParts.PersonalizationEntry -> unit
override this.Add : string * System.Web.UI.WebControls.WebParts.PersonalizationEntry -> unit

Public Overridable Sub Add (key As String, value As PersonalizationEntry)

參數

key

String

狀態資訊的唯一識別項。

value

PersonalizationEntry

要加入個人化字典的狀態資訊。 這個值可以是 null。

例外狀況

ArgumentException

key 是字典中已有索引鍵的複製。

-或- key 為空字串 ("")，或修剪 key 的結果為空字串。

-或- value 不是 PersonalizationEntry。

ArgumentNullException

key 為 null。

-或- value 為 null。

備註

您可以呼叫這個方法，將不同的自訂狀態資訊部分放入狀態物件，並指定與狀態值相關聯的範圍。 當 WebPartManager 控制項在範圍內時 Shared ，您可以加入與 Shared 範圍或範圍相關聯的名稱和狀態資訊 User 。 在 [範圍] 中 User ，您只能新增與範圍相關聯的名稱和狀態資訊 User 。

但是，不論頁面的範圍為何，都可以使用 Save 包含或範圍的屬性將所有屬性新增至字典 User Shared 。

.NET Framework 只會 Shared 在適當時儲存具有範圍的屬性。 換句話說，當一 WebPart 開始在範圍中新增的控制項在範圍內儲存時，不會儲存共用的屬性 Shared User 。 在相反的情況下，如果 WebPart 控制項已加入至範圍中的頁面 User ，而且稍後在頁面位於範圍內時儲存控制項 Shared ，則會將自訂的共用屬性值儲存 (以及自訂的使用者範圍屬性) 。 如需個人化資料的詳細資訊，以及共用和使用者範圍屬性如何受到頁面的個人化範圍影響，請參閱 Web 組件個人化總覽 主題。

如同任何集合，這個方法會將集合計數遞增1，且集合上目前作用中的任何枚舉器都應該無效。

另請參閱

• Web 組件個人化總覽