Partilhar via


WebPart.SetPersonalizationDirty Método

Definição

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 -> unit
Public Shared Sub SetPersonalizationDirty (control As Control)

Parâmetros

control
Control

O Control para o qual os dados de personalização foram alterados.

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 de 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 -> unit
Protected Sub SetPersonalizationDirty ()

Exceções

Comentários

O SetPersonalizationDirty método define um sinalizador que indica 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, o WebPartManager persiste as 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 nos dados de estado de controle durante uma solicitação GET não são persistentes (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.

Confira também

Aplica-se a