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 posizionato in una WebPartZoneBase zona.
Overload
| Nome | Descrizione |
|---|---|
| SetPersonalizationDirty(Control) |
Imposta un flag che indica che i dati di personalizzazione sono stati modificati per il controllo server specificato che risiede in una WebPartZoneBase zona. |
| SetPersonalizationDirty() |
Imposta un flag che indica che i dati di personalizzazione sono stati modificati per l'istanza del controllo corrente WebPart . |
SetPersonalizationDirty(Control)
Imposta un flag che indica che i dati di personalizzazione sono stati modificati per il controllo server specificato che risiede in una 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)Parametri
Eccezioni
L'oggetto control nel parametro è null.
Il controllo non è associato a una pagina.
oppure
Il controllo deriva da WebPart. I controlli che derivano da WebPart devono usare invece il metodo protetto SetPersonalizationDirty() .
La pagina associata al controllo non dispone di un oggetto WebPartManager.
Commenti
Il WebPart.SetPersonalizationDirty metodo ha lo stesso scopo del WebPart.SetPersonalizationDirty() metodo , ovvero impostare 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 posizionati all'interno WebPartZoneBase delle zone per partecipare alle applicazioni web part.
Vedi anche
Si applica a
SetPersonalizationDirty()
Imposta un flag che indica che i dati di personalizzazione sono stati modificati per l'istanza del controllo corrente WebPart .
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 del controllo sono stati modificati (personalizzati) in un WebPart controllo e che il WebPartManager controllo deve pertanto rendere persistenti i dati di personalizzazione in un archivio a lungo termine.
In genere, le WebPartManager modifiche alla personalizzazione vengono mantenute nei WebPart controlli senza la necessità per gli sviluppatori di chiamare il SetPersonalizationDirty metodo . Esistono tuttavia due casi in cui gli sviluppatori devono chiamare questo metodo. Il primo caso consiste nel caso in cui i dati sullo stato del controllo vengano modificati durante una richiesta HTTP GET in una pagina. Per impostazione predefinita, le modifiche ai dati dello stato di controllo durante una GET richiesta non vengono rese persistenti (a scopo di sicurezza). Ma il SetPersonalizationDirty metodo consente di 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 dispone di proprietà personalizzabili complesse,ad esempio una proprietà che contiene un ArrayList oggetto, e i dati sullo stato del controllo in tali proprietà vengono personalizzati durante una POST richiesta, gli sviluppatori devono chiamare il SetPersonalizationDirty metodo per assicurarsi che le modifiche vengano mantenute.