IVersioningPersonalizable.Load(IDictionary) Método

Definição

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Carrega os dados de personalização para um controle de Web Parts que não tem uma propriedade personalizada correspondente para os dados devido a uma alteração de versão.

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

Um dicionário de dados de personalização que não puderam ser aplicados a um controle.

Comentários

O unknownProperties parâmetro contém uma representação mesclada de dados de personalização desconhecidos, do escopo "usuário" e "compartilhado", que não pôde ser aplicado ao controle. Quando uma página está sendo executada no escopo do usuário, os valores de escopo do usuário desconhecido são fornecidos (se disponíveis) em vez de valores de escopo compartilhado desconhecidos. Essas informações são armazenadas como uma série de pares de nome/valor, em que cada nome é o nome da cadeia de caracteres de uma propriedade que não foi encontrada no controle e cada valor contém o valor da propriedade. É responsabilidade do controle converter ou converter o valor para o tipo apropriado e realizar processamento adicional (como o mapeamento de dados de uma propriedade antiga para uma nova propriedade).

Se o estado de um controle for alterado, ele deverá chamar SetPersonalizationDirty (o método herdado ou o método estático público no caso de um controle que não derive de WebPart ). se um controle se marca como "sujo", o conjunto de controle de Web Parts extrairá os dados de personalização do controle, independentemente do estado "sujo" do controle, e o salvará de volta no armazenamento de dados subjacente posteriormente no ciclo de vida da personalização. Um controle deve se marcar como "sujo" se, como resultado do processamento dos valores no unknownProperties parâmetro, o estado do controle foi alterado.

observe que, se forem detectadas propriedades órfãas ao importar Web Parts controles, esse método será chamado automaticamente.