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 personalizzate nell'oggetto stato e specificare l'ambito associato al valore di stato. Quando un WebPartManager controllo è nell' Shared ambito, è possibile aggiungere informazioni sul nome e sullo stato associate a ambito Shared o User ambito. In User ambito è possibile aggiungere informazioni sul nome e sullo stato associate solo all' User ambito.
Tuttavia, è consigliabile aggiungere tutte le proprietà al dizionario usando le Save proprietà incluse con l' User Shared ambito o, indipendentemente dall'ambito della pagina.
Il .NET Framework Salva solo le proprietà con Shared ambito quando appropriato. In altre parole, le proprietà condivise non vengono salvate quando un WebPart controllo aggiunto inizialmente nell' Shared ambito viene salvato in un secondo momento mentre la pagina si trova nell' User ambito. In uno scenario opposto, se un WebPart controllo è stato aggiunto alla pagina nell' User ambito e il controllo viene salvato in un secondo momento mentre la pagina si trova nell' Shared ambito, vengono salvati i valori delle proprietà condivise personalizzate, insieme alle proprietà personalizzate con ambito di utente. Per informazioni dettagliate sui dati sulla personalizzazione e sul modo in cui le proprietà condivise e con ambito utente sono interessate dall'ambito di personalizzazione della pagina, vedere l'argomento Cenni preliminari sulla personalizzazione della web part .
Come con qualsiasi raccolta, questo metodo incrementa il numero di raccolte di uno e tutti gli enumeratori attualmente attivi nella raccolta devono essere invalidati.