WebPart.SetPersonalizationDirty Метод

Определение

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

System.Web.UI.WebControls.WebParts

Сборка:

System.Web.dll

Устанавливает флаг, указывающий на изменение данных персонализации для элемента управления веб-частей или серверного элемента управления, находящегося в зоне 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 -> unit

Public Shared Sub SetPersonalizationDirty (control As Control)

Параметры

control

Control

Элемент управления Control, данные персонализации которого были изменены.

Исключения

ArgumentNullException

Объект в параметре control равен null.

ArgumentException

Элемент управления не связан со страницей.

-или-

Элемент управления является производным из WebPart. Элементы управления, производные из WebPart, должны использовать вместо этого защищенный метод SetPersonalizationDirty().

InvalidOperationException

Страница, связанная с элементом управления, не содержит объект WebPartManager.

Комментарии

Метод WebPart.SetPersonalizationDirty имеет ту же цель, что и метод , который заключается в WebPart.SetPersonalizationDirty() том, чтобы установить флаг, указывающий, что данные состояния элемента управления были изменены (персонализированы) в серверном элементе управления во время HTTP-запроса GET . Разница между этими методами заключается в WebPart.SetPersonalizationDirty том, что метод используется для серверных элементов управления, которые не наследуются от WebPart класса , но помещаются в WebPartZoneBase зоны для участия в приложениях веб-частей.

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

• элементы управления веб-частей ASP.NET

SetPersonalizationDirty()

Устанавливает флаг, указывающий на изменение данных персонализации для текущего экземпляра элемента управления WebPart.

protected:
 void SetPersonalizationDirty();

protected void SetPersonalizationDirty ();

member this.SetPersonalizationDirty : unit -> unit

Protected Sub SetPersonalizationDirty ()

Исключения

InvalidOperationException

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

Комментарии

Метод SetPersonalizationDirty устанавливает флаг, указывающий, что данные состояния элемента управления были изменены (персонализированы) в элементе WebPart управления и что WebPartManager элементу управления необходимо сохранить данные персонализации в долгосрочном хранилище.

Как правило, WebPartManager сохраняет изменения персонализации в WebPart элементах управления без необходимости вызова SetPersonalizationDirty метода разработчиками. Но есть два случая, когда разработчики должны вызвать этот метод. Первый случай — изменение данных состояния элемента управления во время HTTP-запроса GET к странице. По умолчанию изменения данных состояния управления во время GET запроса не сохраняются (в целях безопасности). Но метод SetPersonalizationDirty предоставляет способ сохранения допустимых изменений WebPart персонализации в элементах управления в этом случае.

Второй случай вызова SetPersonalizationDirty метода происходит во время HTTP-запроса POST к странице. WebPart Если элемент управления имеет сложные персонализируемые свойства (например, свойство, содержащее ArrayList объект), а данные состояния элемента управления в этих свойствах персонализовываются во время POST запроса, разработчики должны вызвать SetPersonalizationDirty метод , чтобы обеспечить сохранение изменений.

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

• элементы управления веб-частей ASP.NET