語言

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範圍內時被儲存，則會儲存自訂共享屬性值（以及自訂的使用者範圍屬性）。 關於個人化資料的詳細資訊，以及共享與使用者範圍屬性如何受到頁面個人化範圍的影響，請參閱 「網頁部分個人化概覽 」主題。

如同任何集合，此方法會將集合數量增加一，且目前活躍於集合的列舉者應被取消。

適用於

另請參閱