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 per una parte di informazioni 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 ("") o il taglio key restituisce una stringa vuota.
oppure
value non è un oggetto PersonalizationEntry.
Commenti
È possibile chiamare questo metodo, inserire varie parti di informazioni sullo stato personalizzate nell'oggetto stato e specificare l'ambito associato al valore di stato. Quando un WebPartManager controllo è incluso nell'ambitoShared, è possibile aggiungere informazioni sul nome e sullo stato associate all'ambito o Shared all'ambitoUser. Nell'ambito User è possibile aggiungere informazioni sul nome e sullo stato associate solo User all'ambito.
È tuttavia consigliabile aggiungere tutte le proprietà al dizionario usando Save proprietà con User o Shared ambito, indipendentemente dall'ambito della pagina.
Il framework di .NET salva solo le proprietà con ambito Shared quando appropriato. In altre parole, le proprietà condivise non vengono salvate quando un WebPart controllo inizialmente aggiunto nell'ambito Shared viene salvato in un secondo momento mentre la pagina è nell'ambito User . In uno scenario opposto, se un WebPart controllo è stato aggiunto alla pagina nell'ambito User e il controllo viene salvato in un secondo momento mentre la pagina è nell'ambito Shared , i valori delle proprietà condivise personalizzate vengono salvati (insieme alle proprietà personalizzate con ambito utente). Per informazioni dettagliate sui dati di personalizzazione e sul modo in cui le proprietà condivise e con ambito utente sono interessate dall'ambito di personalizzazione della pagina, vedere l'argomento Panoramica della personalizzazione delle web part .
Come per qualsiasi raccolta, questo metodo incrementa il numero di raccolte di uno e gli enumeratori attualmente attivi nella raccolta devono essere invalidati.
