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 una marca que indica que los datos de personalización han cambiado para un control de elementos web o un control de servidor colocado en una WebPartZoneBase zona.
Sobrecargas
| Nombre | Description |
|---|---|
| SetPersonalizationDirty(Control) |
Establece una marca que indica que los datos de personalización han cambiado para el control de servidor especificado que reside en una WebPartZoneBase zona. |
| SetPersonalizationDirty() |
Establece una marca que indica que los datos de personalización han cambiado para la instancia de control actual WebPart . |
SetPersonalizationDirty(Control)
Establece una marca que indica que los datos de personalización han cambiado para el control de servidor especificado que reside en una WebPartZoneBase zona.
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 control parámetro es null.
El control no está asociado a una página.
O bien
El control deriva de WebPart. En su lugar, los controles que derivan de WebPart deben usar el método protegido SetPersonalizationDirty() .
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 es 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 las zonas para participar en las aplicaciones de elementos web.
Consulte también
Se aplica a
SetPersonalizationDirty()
Establece una marca que indica que los datos de personalización han cambiado para la instancia de control actual 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 tanto, el WebPart control debe conservar los datos de personalización en el WebPartManager almacenamiento a largo plazo.
Normalmente, conserva los WebPartManager 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.
