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 -> unitPublic 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 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.
