PersonalizationDictionary.Add(String, PersonalizationEntry) Metodo

Definizione

Aggiunge voci di personalizzazione al dizionario di personalizzazione.Adds personalization entries to the personalization dictionary.

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 -> unit
Public Overridable Sub Add (key As String, value As PersonalizationEntry)

Parametri

key
String

Identificatore univoco di un'informazione sullo stato.The unique identifier for a piece of state information.

value
PersonalizationEntry

Informazioni sullo stato da aggiungere al dizionario di personalizzazione.A piece of state information to be added to the personalization dictionary. Il valore può essere null.This value can be null.

Eccezioni

key è un duplicato di una chiave già presente nel dizionario.key is a duplicate of a key already in the dictionary.

-oppure--or- key è una stringa vuota (""); se key viene tagliato, produce una stringa vuota.key is either an empty string ("") or trimming key results in an empty string.

-oppure--or- value non è un oggetto PersonalizationEntry.value is not a PersonalizationEntry.

key è null.key is null.

-oppure--or- value è null.value is null.

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.You can call this method, place various pieces of custom state information into the state object, and specify the scope associated with the state value. Quando un WebPartManager controllo è nell' Shared ambito, è possibile aggiungere informazioni sul nome e sullo stato associate a ambito Shared o User ambito.When a WebPartManager control is in Shared scope, you can add name and state information that is associated with either Shared scope or User scope. In User ambito è possibile aggiungere informazioni sul nome e sullo stato associate solo all' User ambito.In User scope, you can add name and state information associated only with User scope.

Tuttavia, è consigliabile aggiungere tutte le proprietà al dizionario usando le Save proprietà incluse con l' User Shared ambito o, indipendentemente dall'ambito della pagina.It is a good practice, however, to add all properties to the dictionary using Save including properties with User or Shared scope, regardless of the scope of the page.

Il .NET Framework Salva solo le proprietà con Shared ambito quando appropriato.The .NET Framework only saves the properties with Shared scope when appropriate. 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 other words, shared properties are not saved when a WebPart control that was initially added in Shared scope is later saved while the page is in User scope. 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.In an opposite scenario, if a WebPart control was added to the page in User scope, and the control is later saved while the page is in Shared scope, custom shared property values are saved (along with custom user-scoped properties). 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 .For details on personalization data and how shared and user-scoped properties are affected by the personalization scope of the page, see the Web Parts Personalization Overview topic.

Come con qualsiasi raccolta, questo metodo incrementa il numero di raccolte di uno e tutti gli enumeratori attualmente attivi nella raccolta devono essere invalidati.As with any collection, this method increments the collection count by one and any enumerators currently active on the collection should be invalidated.

Si applica a