IVersioningPersonalizable.Load(IDictionary) 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í.
Carga los datos de personalización a un control de elementos web que no tiene una propiedad personalizada correspondiente para los datos debido a un cambio de versión.
public:
void Load(System::Collections::IDictionary ^ unknownProperties);public void Load (System.Collections.IDictionary unknownProperties);abstract member Load : System.Collections.IDictionary -> unitPublic Sub Load (unknownProperties As IDictionary)Parámetros
- unknownProperties
- IDictionary
Diccionario de datos de personalización que no se puede aplicar a un control.
Comentarios
El unknownProperties parámetro contiene una representación combinada de datos de personalización desconocidos, del ámbito "Usuario" y "Compartido", que no se pudo aplicar al control. Cuando se ejecuta una página en el ámbito de usuario, se proporcionan los valores de ámbito de usuario desconocidos (si están disponibles) en lugar de valores de ámbito compartido desconocidos. Esta información se almacena como una serie de pares nombre-valor donde cada nombre es el nombre de cadena de una propiedad que no se encontró en el control y cada valor contiene el valor de propiedad. Es responsabilidad del control convertir o convertir el valor en el tipo adecuado y llevar a cabo un procesamiento posterior (como asignar datos de una propiedad antigua a una nueva propiedad).
Si cambia el estado de un control, debe llamar a SetPersonalizationDirty (ya sea el método heredado o el método estático público en el caso de un control que no deriva de WebPart). Si un control se marca como "sucio", el conjunto de controles de elementos web extraerá los datos de personalización del control, independientemente del estado "sucio" del control y lo guardará de nuevo en el almacén de datos subyacente más adelante en el ciclo de vida de personalización. Un control debe marcarse como "sucio" si, como resultado del procesamiento de los valores en el unknownProperties parámetro , el estado del control ha cambiado.
Tenga en cuenta que si se detectan propiedades huérfanas al importar controles de elementos web, se llama automáticamente a este método.
