PersonalizationDictionary.Add(String, PersonalizationEntry) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
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.
Comentarios
Puede llamar a este método, colocar varias partes de la información de estado personalizada en el objeto de estado y especificar el ámbito asociado con el valor de estado. Cuando un WebPartManager control está en Shared el ámbito, puede agregar información de nombre y estado que está asociada a un ámbito Shared o ámbito User . En User ámbito, puede agregar información de nombre y estado asociada solo al User ámbito.
Sin embargo, se recomienda 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.
El .NET Framework solo guarda las propiedades con el Shared ámbito cuando sea necesario. En otras palabras, las propiedades compartidas no se guardan cuando un WebPart control que se agregó inicialmente en Shared el ámbito se guarda posteriormente mientras la página está en el User ámbito. En un escenario opuesto, si WebPart se agregó un control a la página en el User ámbito, y el control se guarda posteriormente mientras la página está en el Shared ámbito, se guardan los valores de propiedad compartidos personalizados (junto con las propiedades de ámbito de usuario personalizadas). Para obtener más información sobre los datos de personalización y cómo se ven afectados por el ámbito de personalización de la página las propiedades de ámbito de usuario y compartidas, vea el tema información general sobre la personalización de elementos Web .
Como con cualquier colección, este método incrementa el recuento de la colección en uno y se deben invalidar los enumeradores actualmente activos en la colección.