WebPart.SetPersonalizationDirty Metodo

Definizione

Spazio dei nomi:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Imposta un flag che indica che i dati di personalizzazione sono stati modificati per un controllo Web part o un controllo server inserito in una zona WebPartZoneBase.

Overload

SetPersonalizationDirty(Control)	Imposta un flag che indica che i dati di personalizzazione sono stati modificati per il controllo server specificato presente in una zona WebPartZoneBase.
SetPersonalizationDirty()	Imposta un flag che indica che i dati di personalizzazione dell'istanza del controllo WebPart corrente sono stati modificati.

SetPersonalizationDirty(Control)

Imposta un flag che indica che i dati di personalizzazione sono stati modificati per il controllo server specificato presente in 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 -> unit

Public Shared Sub SetPersonalizationDirty (control As Control)

Parametri

control

Control

Controllo Control per il quale sono stati modificati i dati sulla personalizzazione.

Eccezioni

ArgumentNullException

L'oggetto contenuto nel parametro control è null.

ArgumentException

Il controllo non è associato a una pagina.

-oppure-

Il controllo deriva da WebPart. I controlli che derivano da WebPart devono utilizzare invece il metodoSetPersonalizationDirty() protetto.

InvalidOperationException

La pagina associata al controllo non dispone di un WebPartManager.

Commenti

Il WebPart.SetPersonalizationDirty metodo ha lo stesso scopo del metodo, che consiste nell'impostare WebPart.SetPersonalizationDirty() un flag che indica che i dati sullo stato del controllo sono stati modificati (personalizzati) in un controllo server durante una richiesta HTTP GET . La differenza tra questi metodi è che il WebPart.SetPersonalizationDirty metodo viene usato per i controlli server che non ereditano dalla WebPart classe, ma vengono inseriti in WebPartZoneBase zone per partecipare alle applicazioni Web part.

Vedi anche

• ASP.NET controlli web part

SetPersonalizationDirty()

Imposta un flag che indica che i dati di personalizzazione dell'istanza del controllo WebPart corrente sono stati modificati.

protected:
 void SetPersonalizationDirty();

protected void SetPersonalizationDirty ();

member this.SetPersonalizationDirty : unit -> unit

Protected Sub SetPersonalizationDirty ()

Eccezioni

InvalidOperationException

WebPartManager è null.

Commenti

Il SetPersonalizationDirty metodo imposta un flag che indica che i dati dello stato di controllo sono stati modificati (personalizzati) in un WebPart controllo e che il WebPartManager controllo deve pertanto rendere persistenti i dati di personalizzazione in un'archiviazione a lungo termine.

In genere, la WebPartManager personalizzazione viene modificata nei WebPart controlli senza la necessità per gli sviluppatori di chiamare il SetPersonalizationDirty metodo. Tuttavia, esistono due casi in cui gli sviluppatori devono chiamare questo metodo. Il primo caso è quando i dati sullo stato del controllo sono modificati durante una richiesta HTTP GET in una pagina. Per impostazione predefinita, le modifiche apportate ai dati sullo stato durante una GET richiesta non vengono mantenute (a scopo di sicurezza). Tuttavia, il SetPersonalizationDirty metodo offre un modo per rendere persistenti le modifiche di personalizzazione legittime ai WebPart controlli in questo caso.

Il secondo caso per chiamare il SetPersonalizationDirty metodo si verifica durante una richiesta HTTP POST a una pagina. Se un WebPart controllo ha proprietà personalizzabili complesse (ad esempio una proprietà contenente un ArrayList oggetto) e i dati sullo stato di controllo in tali proprietà vengono personalizzati durante una POST richiesta, gli sviluppatori devono chiamare il SetPersonalizationDirty metodo per assicurarsi che le modifiche siano persistenti.

Vedi anche

• ASP.NET controlli web part