WebPart.SetPersonalizationDirty Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Устанавливает флаг, указывающий на изменение данных персонализации для элемента управления веб-частей или серверного элемента управления, находящегося в зоне WebPartZoneBase.
Перегрузки
| SetPersonalizationDirty(Control) |
Устанавливает флаг, указывающий на изменение данных персонализации для указанного серверного элемента управления, который находится в зоне WebPartZoneBase. |
| SetPersonalizationDirty() |
Устанавливает флаг, указывающий на изменение данных персонализации для текущего экземпляра элемента управления WebPart. |
SetPersonalizationDirty(Control)
Устанавливает флаг, указывающий на изменение данных персонализации для указанного серверного элемента управления, который находится в зоне WebPartZoneBase.
public:
static void SetPersonalizationDirty(System::Web::UI::Control ^ control);public static void SetPersonalizationDirty (System.Web.UI.Control control);static member SetPersonalizationDirty : System.Web.UI.Control -> unitPublic Shared Sub SetPersonalizationDirty (control As Control)Параметры
Исключения
Объект в параметре control равен null.
Элемент управления не связан со страницей.
-или-
Элемент управления является производным из WebPart. Элементы управления, производные из WebPart, должны использовать вместо этого защищенный метод SetPersonalizationDirty().
Страница, связанная с элементом управления, не содержит объект WebPartManager.
Комментарии
Метод WebPart.SetPersonalizationDirty имеет ту же цель, что и метод , который заключается в WebPart.SetPersonalizationDirty() том, чтобы установить флаг, указывающий, что данные состояния элемента управления были изменены (персонализированы) в серверном элементе управления во время HTTP-запроса GET . Разница между этими методами заключается в WebPart.SetPersonalizationDirty том, что метод используется для серверных элементов управления, которые не наследуются от WebPart класса , но помещаются в WebPartZoneBase зоны для участия в приложениях веб-частей.
См. также раздел
Применяется к
SetPersonalizationDirty()
Устанавливает флаг, указывающий на изменение данных персонализации для текущего экземпляра элемента управления WebPart.
protected:
void SetPersonalizationDirty();protected void SetPersonalizationDirty ();member this.SetPersonalizationDirty : unit -> unitProtected Sub SetPersonalizationDirty ()Исключения
WebPartManager имеет значение null.
Комментарии
Метод SetPersonalizationDirty устанавливает флаг, указывающий, что данные состояния элемента управления были изменены (персонализированы) в элементе WebPart управления и что WebPartManager элементу управления необходимо сохранить данные персонализации в долгосрочном хранилище.
Как правило, WebPartManager сохраняет изменения персонализации в WebPart элементах управления без необходимости вызова SetPersonalizationDirty метода разработчиками. Но есть два случая, когда разработчики должны вызвать этот метод. Первый случай — изменение данных состояния элемента управления во время HTTP-запроса GET к странице. По умолчанию изменения данных состояния управления во время GET запроса не сохраняются (в целях безопасности). Но метод SetPersonalizationDirty предоставляет способ сохранения допустимых изменений WebPart персонализации в элементах управления в этом случае.
Второй случай вызова SetPersonalizationDirty метода происходит во время HTTP-запроса POST к странице.
WebPart Если элемент управления имеет сложные персонализируемые свойства (например, свойство, содержащее ArrayList объект), а данные состояния элемента управления в этих свойствах персонализовываются во время POST запроса, разработчики должны вызвать SetPersonalizationDirty метод , чтобы обеспечить сохранение изменений.
