PersonalizationDictionary.Add(String, PersonalizationEntry) Метод

Определение

Добавляет записи персонализации в словарь персонализации.

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.

Исключения

Параметр key совпадает с ключом, уже находящимся в словаре.

-или-

Параметр key представляет пустую строку (""), или в результате усечения параметра key образуется пустая строка.

-или-

value не является объектом типа PersonalizationEntry.

key имеет значение null.

-или-

value имеет значение null.

Комментарии

Этот метод можно вызвать, поместить различные пользовательские сведения о состоянии в объект состояния и указать область, связанную со значением состояния. Если элемент WebPartManager управления находится в Shared области, можно добавить сведения об имени и состоянии, связанные с Shared областью или User областью. В User область можно добавить сведения об имени и состоянии, связанные только с областью User .

Однако рекомендуется добавлять в словарь все свойства, включая Save свойства с User областью или Shared , независимо от области страницы.

Платформа .NET Framework сохраняет свойства только с Shared областью, если это необходимо. Другими словами, общие свойства не сохраняются, когда WebPart элемент управления, который был первоначально добавлен в Shared область, позже сохраняется, пока страница находится в User области. В противоположном сценарии, если WebPart элемент управления был добавлен на страницу в User области, а элемент управления позже сохраняется, пока страница находится в Shared области, сохраняются значения пользовательских общих свойств (наряду с пользовательскими свойствами). Дополнительные сведения о данных персонализации и о том, как область персонализации страницы влияет на общие и пользовательские свойства, см. в разделе Обзор персонализации веб-частей .

Как и в случае с любой коллекцией, этот метод увеличивает количество коллекций на единицу, и все перечислители, активные в коллекции, должны быть недействительными.

Применяется к

См. также раздел