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 de un fragmento de información de estado.
- value
- PersonalizationEntry
Fragmento 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 que ya está en el diccionario.
O bien
key es una cadena vacía ("") o el key recorte da como resultado una cadena vacía.
O bien
valueno es .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 Shared al User á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 la inclusión Save de propiedades con User o Shared ámbito, independientemente del ámbito de la página.
.NET Framework solo guarda las propiedades con 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 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 posteriormente 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.
