Share via


IVersioningPersonalizable.Load(IDictionary) Método

Definición

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 -> unit
Public 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.

Se aplica a