PersonalizationDictionary.Add(String, PersonalizationEntry) 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.
Aggiunge voci di personalizzazione al dizionario di personalizzazione.
public:
virtual void Add(System::String ^ key, System::Web::UI::WebControls::WebParts::PersonalizationEntry ^ value);public virtual void Add (string key, System.Web.UI.WebControls.WebParts.PersonalizationEntry value);abstract member Add : string * System.Web.UI.WebControls.WebParts.PersonalizationEntry -> unit
override this.Add : string * System.Web.UI.WebControls.WebParts.PersonalizationEntry -> unitPublic Overridable Sub Add (key As String, value As PersonalizationEntry)Parametri
- key
- String
Identificatore univoco di un'informazione sullo stato.
- value
- PersonalizationEntry
Informazioni sullo stato da aggiungere al dizionario di personalizzazione. Il valore può essere null.
Eccezioni
key è un duplicato di una chiave già presente nel dizionario.
-oppure-
key è una stringa vuota (""); se key viene tagliato, produce una stringa vuota.
-oppure-
value non è un oggetto PersonalizationEntry.
Commenti
È possibile chiamare questo metodo, inserire varie parti di informazioni sullo stato nell'oggetto stato e specificare l'ambito associato al valore dello stato. Quando un WebPartManager controllo si trova nell'ambitoShared, è possibile aggiungere informazioni sul nome e sullo stato associate all'ambito o User all'ambitoShared. Nell'ambito User è possibile aggiungere informazioni sul nome e sullo stato associate solo all'ambito User .
È tuttavia consigliabile aggiungere tutte le proprietà al dizionario usando proprietà con SaveUser o Shared ambito, indipendentemente dall'ambito della pagina.
.NET Framework salva solo le proprietà con Shared ambito quando appropriato. In altre parole, le proprietà condivise non vengono salvate quando viene salvato un WebPart controllo che inizialmente è stato aggiunto nell'ambito mentre la pagina è nell'ambito SharedUser . In uno scenario opposto, se un WebPart controllo è stato aggiunto alla pagina nell'ambito e il controllo viene salvato successivamente mentre la pagina si trova nell'ambito UserShared , vengono salvati i valori delle proprietà condivise personalizzate (insieme alle proprietà con ambito utente personalizzate). Per informazioni dettagliate sui dati di personalizzazione e sul modo in cui le proprietà con ambito utente e condiviso sono interessate dall'ambito di personalizzazione della pagina, vedere l'argomento Panoramica sulla personalizzazione delle web part .
Come per qualsiasi raccolta, questo metodo incrementa il conteggio della raccolta per uno e tutti gli enumeratori attualmente attivi nella raccolta devono essere invalidati.
