PersonalizationDictionary.Add(String, PersonalizationEntry) Método

Definición

Espacio de nombres:

System.Web.UI.WebControls.WebParts

Ensamblado:

System.Web.dll

Agrega entradas de personalización al diccionario de personalización.

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)

Parámetros

key

String

Identificador único para un elemento de información de estado.

value

PersonalizationEntry

Elemento de información de estado que se va a agregar al diccionario de personalización. Este valor puede ser null.

Excepciones

ArgumentException

key es un duplicado de una clave existente en el diccionario.

o bien

key o bien es una cadena vacía ("") o al recortar key se obtiene una cadena vacía.

o bien

value no es un PersonalizationEntry.

ArgumentNullException

key es null.

O bien

value es null.

Comentarios

Puede llamar a este método, colocar varios fragmentos de información de estado personalizado en el objeto de estado y especificar el ámbito asociado al valor de estado. Cuando un WebPartManager control está en Shared el ámbito, puede agregar información de nombre y estado asociada al ámbito o User al Shared ámbito. En User el ámbito, puede agregar información de nombre y estado asociada solo al User ámbito.

Sin embargo, es recomendable agregar todas las propiedades al diccionario mediante Save la inclusión de propiedades con User o Shared ámbito, independientemente del ámbito de la página.

.NET Framework solo guarda las propiedades con Shared ámbito cuando corresponda. En otras palabras, las propiedades compartidas no se guardan cuando un WebPart control que se agregó inicialmente en Shared el ámbito se guarda más adelante mientras la página está en User el ámbito. En un escenario opuesto, si se agregó un WebPart control a la página en User el ámbito y el control se guarda más adelante mientras la página está en Shared el ámbito, los valores de propiedad compartida personalizados se guardan (junto con propiedades personalizadas con ámbito de usuario). Para obtener más información sobre los datos de personalización y cómo las propiedades compartidas y de ámbito de usuario se ven afectadas por el ámbito de personalización de la página, consulte el tema Información general sobre personalización de elementos web .

Al igual que con cualquier colección, este método incrementa el recuento de colecciones por uno y todos los enumeradores activos actualmente en la colección deben invalidarse.

Consulte también

• Información general sobre la personalización de elementos web