WebPart.SetPersonalizationDirty Método

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls.WebParts
Ensamblado:
System.Web.dll

Establece un marcador que refleja que los datos de personalización han cambiado para un control de elementos Web o para un control de servidor colocado en una zona WebPartZoneBase.

Sobrecargas

SetPersonalizationDirty(Control)

Establece un marcador que muestra que los datos de personalización han cambiado para el control de servidor especificado que reside en una zona WebPartZoneBase.
SetPersonalizationDirty()

Establece un marcador que muestra que han cambiado los datos de personalización de la instancia actual del control WebPart.

SetPersonalizationDirty(Control)

Establece un marcador que muestra que los datos de personalización han cambiado para el control de servidor especificado que reside en una zona 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)

Parámetros

control
Control

Control Control cuyos datos de personalización han cambiado.

Excepciones

ArgumentNullException

El objeto del parámetro control es null.

ArgumentException

El control no está asociado a una página.

o bien

El control deriva de WebPart. Los controles que derivan de WebPart deberían utilizar el método protegido SetPersonalizationDirty() en su lugar.

InvalidOperationException

La página asociada al control no tiene WebPartManager.

Comentarios

El WebPart.SetPersonalizationDirty método tiene el mismo propósito que el WebPart.SetPersonalizationDirty() método , que consiste en establecer una marca que indica que los datos de estado de control se han cambiado (personalizados) en un control de servidor durante una solicitud HTTP GET . La diferencia entre estos métodos es que el WebPart.SetPersonalizationDirty método se usa para los controles de servidor que no heredan de la WebPart clase , pero se colocan dentro de WebPartZoneBase zonas para participar en las aplicaciones de elementos web.

Consulte también

Se aplica a

SetPersonalizationDirty()

Establece un marcador que muestra que han cambiado los datos de personalización de la instancia actual del control WebPart.

protected:
 void SetPersonalizationDirty();
protected void SetPersonalizationDirty ();
member this.SetPersonalizationDirty : unit -> unit
Protected Sub SetPersonalizationDirty ()

Excepciones

InvalidOperationException

WebPartManager es null.

Comentarios

El SetPersonalizationDirty método establece una marca que indica que los datos de estado de control se han cambiado (personalizados) en un control y que, por lo tanto, el WebPartManager control debe conservar los datos de personalización en el WebPart almacenamiento a largo plazo.

Normalmente, conserva WebPartManager los cambios de personalización en WebPart los controles sin necesidad de que los desarrolladores llamen al SetPersonalizationDirty método . Pero hay dos casos en los que los desarrolladores necesitan llamar a este método. El primer caso es cuando se cambian los datos de estado de control durante una solicitud HTTP GET a una página. De forma predeterminada, los cambios en los datos de estado durante una GET solicitud no se conservan (con fines de seguridad). Pero el SetPersonalizationDirty método proporciona una manera de conservar los cambios legítimos de personalización en WebPart los controles en este caso.

El segundo caso para llamar al SetPersonalizationDirty método se produce durante una solicitud HTTP POST a una página. Si un WebPart control tiene propiedades personalizables complejas (como una propiedad que contiene un ArrayList objeto) y los datos de estado de control de esas propiedades se personalizan durante una POST solicitud, los desarrolladores deben llamar al SetPersonalizationDirty método para asegurarse de que los cambios se conservan.

Consulte también

Se aplica a