WebPart.SetPersonalizationDirty Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> unitPublic Shared Sub SetPersonalizationDirty (control As Control)Parámetros
Excepciones
El objeto del parámetro control es null.
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.
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 -> unitProtected Sub SetPersonalizationDirty ()Excepciones
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.
