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範圍內時，您可以新增與範圍或User範圍相關聯的Shared名稱和狀態資訊。 在範圍中 User ，您可以新增僅與範圍相關聯的 User 名稱和狀態資訊。

不過，不論頁面的範圍為何，使用包含屬性User或Shared範圍，將所有屬性加入字典Save是很好的作法。

.NET Framework 只有在適當時，才會儲存具有 Shared 範圍的屬性。 換句話說，在頁面位於User範圍內時，一開始加入Shared範圍的控件儲存時WebPart，不會儲存共用屬性。 相反的案例中，如果 WebPart 控件已新增至範圍中的 User 頁面，且稍後在頁面位於 Shared 範圍內時儲存控件，則會 (儲存自定義共用屬性值以及自定義使用者範圍屬性) 。 如需個人化數據的詳細數據，以及共用和使用者範圍屬性如何受到頁面的個人化範圍影響，請參閱 Web元件個人化概觀 主題。

如同任何集合，這個方法會將集合計數遞增一，而且集合上目前使用的任何列舉值都應該失效。

另請參閱

• Web 元件個人化概觀