WebPart.SetPersonalizationDirty Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Define um sinalizador que indica que os dados de personalização foram alterados para um controle de Web Parts ou um controle de servidor colocado em uma zona WebPartZoneBase.
Sobrecargas
| SetPersonalizationDirty(Control) |
Define um sinalizador que indica que os dados de personalização foram alterados para o controle de servidor especificado que reside em uma zona WebPartZoneBase. |
| SetPersonalizationDirty() |
Define um sinalizador que indica que os dados de personalização foram alterados para a instância de controle WebPart atual. |
SetPersonalizationDirty(Control)
Define um sinalizador que indica que os dados de personalização foram alterados para o controle de servidor especificado que reside em uma 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
Exceções
O objeto no parâmetro control é null.
O controle não está associado a uma página.
- ou - O controle é derivado de WebPart. Controles que derivam de WebPart devem usar o método SetPersonalizationDirty() protegido em vez disso.
A página associada ao controle não tem um WebPartManager.
Comentários
O WebPart.SetPersonalizationDirty método tem a mesma finalidade que o WebPart.SetPersonalizationDirty() método, que é definir um sinalizador indicando que os dados de estado de controle foram alterados (personalizados) em um controle de servidor durante uma solicitação HTTP GET . A diferença entre esses métodos é que o WebPart.SetPersonalizationDirty método é usado para controles de servidor que não herdam da WebPart classe, mas são colocados dentro WebPartZoneBase de zonas para participar de aplicativos Web Parts.
Confira também
Aplica-se a
SetPersonalizationDirty()
Define um sinalizador que indica que os dados de personalização foram alterados para a instância de controle WebPart atual.
protected:
void SetPersonalizationDirty();protected void SetPersonalizationDirty ();member this.SetPersonalizationDirty : unit -> unitProtected Sub SetPersonalizationDirty ()Exceções
Comentários
O SetPersonalizationDirty método define um sinalizador indicando que os dados de estado de controle foram alterados (personalizados) em um WebPart controle e que, portanto, o WebPartManager controle precisa persistir os dados de personalização para o armazenamento de longo prazo.
Normalmente, persiste as WebPartManager alterações de personalização nos WebPart controles sem a necessidade de os desenvolvedores chamarem o SetPersonalizationDirty método. Mas há dois casos em que os desenvolvedores precisam chamar esse método. O primeiro caso é quando os dados de estado de controle são alterados durante uma solicitação HTTP GET para uma página. Por padrão, as alterações no controle de dados de estado durante uma solicitação GET não são mantidas (para fins de segurança). Mas o SetPersonalizationDirty método fornece uma maneira de persistir alterações legítimas de personalização nos WebPart controles nesse caso.
O segundo caso para chamar o SetPersonalizationDirty método ocorre durante uma solicitação HTTP POST para uma página. Se um WebPart controle tiver propriedades personalizáveis complexas (como uma propriedade que contém um ArrayList objeto) e os dados de estado de controle nessas propriedades forem personalizados durante uma POST solicitação, os desenvolvedores deverão chamar o SetPersonalizationDirty método para garantir que as alterações sejam mantidas.