IVersioningPersonalizable.Load(IDictionary) Метод

Определение

Пространство имен:

System.Web.UI.WebControls.WebParts

Сборка:

System.Web.dll

Загружает данные персонализации в элемент управления веб-частей, который не поддерживает соответствующее персональное свойство для данных из-за изменения версии.

public:
 void Load(System::Collections::IDictionary ^ unknownProperties);

public void Load (System.Collections.IDictionary unknownProperties);

abstract member Load : System.Collections.IDictionary -> unit

Public Sub Load (unknownProperties As IDictionary)

Параметры

unknownProperties

IDictionary

Словарь данных персонализации, которые не удалось применить к элементу управления.

Комментарии

unknownPropertiesПараметр содержит объединенное представление неизвестных данных персонализации в области "User" и "Shared", которые не могут быть применены к элементу управления. При выполнении страницы в области пользователя предоставляются неизвестные значения области пользователя (если они доступны), а не неизвестные значения общей области. Эти сведения хранятся в виде последовательности пар "имя-значение", где каждое имя является строковым именем свойства, которое не было найдено в элементе управления, и каждое значение содержит значение свойства. Элемент управления обязан привести или преобразовать значение в соответствующий тип и выполнить дальнейшую обработку (например, сопоставление данных из старого свойства с новым свойством).

При изменении состояния элемента управления он должен вызвать SetPersonalizationDirty (унаследованный метод или открытый статический метод в случае элемента управления, который не является производным от WebPart ). если элемент управления помечает себя как "грязный", набор элементов управления веб-части будет извлекать данные персонализации из элемента управления независимо от состояния "грязного" элемента управления и сохранять его в базовом хранилище данных позже в жизненном цикле персонализации. Элемент управления должен помечать себя как "грязный", если в результате обработки значений в unknownProperties параметре состояние элемента управления изменилось.

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