WebPart.SetPersonalizationDirty Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 -> unitPublic Shared Sub SetPersonalizationDirty (control As Control)Parametri
- control
- Control
Controllo Control per il quale sono stati modificati i dati sulla personalizzazione.
Eccezioni
L'oggetto contenuto nel parametro control è null.
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.
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
Si applica a
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 -> unitProtected Sub SetPersonalizationDirty ()Eccezioni
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 nell'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.
