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 -> unitPublic Overridable Sub Add (key As String, value As PersonalizationEntry)Параметры
- key
- String
Уникальный идентификатор для компонента данных о состоянии.
- value
- PersonalizationEntry
Компонент данных о состоянии, добавляемый в словарь персонализации. Это значение может быть равно null.
Исключения
Параметр key совпадает с ключом, уже находящимся в словаре.
-или-
Параметр key представляет пустую строку (""), или в результате усечения параметра key образуется пустая строка.
-или-
value не является объектом типа PersonalizationEntry.
Комментарии
Этот метод можно вызвать, поместить различные пользовательские сведения о состоянии в объект состояния и указать область, связанную со значением состояния. Если элемент WebPartManager управления находится в Shared области, можно добавить сведения об имени и состоянии, связанные с Shared областью или User областью. В User область можно добавить сведения об имени и состоянии, связанные только с областью User .
Однако рекомендуется добавлять в словарь все свойства, включая Save свойства с User областью или Shared , независимо от области страницы.
Платформа .NET Framework сохраняет свойства только с Shared областью, если это необходимо. Другими словами, общие свойства не сохраняются, когда WebPart элемент управления, который был первоначально добавлен в Shared область, позже сохраняется, пока страница находится в User области. В противоположном сценарии, если WebPart элемент управления был добавлен на страницу в User области, а элемент управления позже сохраняется, пока страница находится в Shared области, сохраняются значения пользовательских общих свойств (наряду с пользовательскими свойствами). Дополнительные сведения о данных персонализации и о том, как область персонализации страницы влияет на общие и пользовательские свойства, см. в разделе Обзор персонализации веб-частей .
Как и в случае с любой коллекцией, этот метод увеличивает количество коллекций на единицу, и все перечислители, активные в коллекции, должны быть недействительными.
