WebPart.SetPersonalizationDirty Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Define um flag indicando que os dados de personalização mudaram para um controlo de Web Parts ou para um controlo de servidor colocado numa WebPartZoneBase zona.
Sobrecargas
| Name | Description |
|---|---|
| SetPersonalizationDirty(Control) |
Define um flag indicando que os dados de personalização foram alterados para o controlo de servidor especificado que reside numa WebPartZoneBase zona. |
| SetPersonalizationDirty() |
Define um flag indicando que os dados de personalização mudaram para a instância de controlo atual WebPart . |
SetPersonalizationDirty(Control)
Define um flag indicando que os dados de personalização foram alterados para o controlo de servidor especificado que reside numa 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
Exceções
O objeto no control parâmetro é null.
O controlo não está associado a uma página.
-ou-
O controlo deriva de WebPart. Os controlos que derivam de WebPart devem usar o método protegido SetPersonalizationDirty() em vez disso.
A página associada ao controlo não tem um WebPartManager.
Observações
O WebPart.SetPersonalizationDirty método tem o mesmo propósito que o WebPart.SetPersonalizationDirty() método, que é definir uma bandeira indicando que os dados do estado de controlo foram alterados (personalizados) num controlo de servidor durante um pedido HTTP GET . A diferença entre estes métodos é que o WebPart.SetPersonalizationDirty método é usado para controlos de servidor que não herdam da WebPart classe, mas são colocados dentro WebPartZoneBase de zonas para participar em aplicações Web Parts.
Ver também
Aplica-se a
SetPersonalizationDirty()
Define um flag indicando que os dados de personalização mudaram para a instância de controlo atual WebPart .
protected:
void SetPersonalizationDirty();protected void SetPersonalizationDirty();member this.SetPersonalizationDirty : unit -> unitProtected Sub SetPersonalizationDirty ()Exceções
Observações
O SetPersonalizationDirty método define uma bandeira indicando que os dados do estado de controlo foram alterados (personalizados) num WebPart controlo, e que o WebPartManager controlo precisa, portanto, de manter os dados de personalização para armazenamento a longo prazo.
Normalmente, as WebPartManager alterações persistentes de personalização nos WebPart controlos sem necessidade de os programadores chamarem o SetPersonalizationDirty método. Mas há dois casos em que os programadores precisam de usar este método. O primeiro caso é quando os dados do estado de controlo são alterados durante um pedido HTTP GET para uma página. Por defeito, as alterações aos dados do estado de controlo durante um GET pedido não são mantidas (por razões de segurança). Mas o SetPersonalizationDirty método fornece uma forma de persistir alterações legítimas de personalização nos WebPart controlos neste caso.
O segundo caso para chamar o SetPersonalizationDirty método ocorre durante um pedido HTTP POST a uma página. Se um WebPart controlo tiver propriedades complexas e personalizáveis (como uma propriedade que contenha um ArrayList objeto), e os dados do estado do controlo nessas propriedades forem personalizados durante um POST pedido, os programadores devem chamar o SetPersonalizationDirty método para garantir que as alterações são mantidas.