IVersioningPersonalizable.Load(IDictionary) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Carrega 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 -> unitPublic Sub Load (unknownProperties As IDictionary)Parâmetros
- unknownProperties
- IDictionary
Um dicionário de dados de personalização que não pôde ser aplicado a um controle.
Comentários
O unknownProperties parâmetro contém uma representação mesclada de dados de personalização desconhecidos, de escopo "Usuário" e "Compartilhado", que não puderam ser aplicados ao controle. Quando uma página está em execução no escopo do usuário, os valores desconhecidos do escopo do usuário são fornecidos (se disponíveis) em vez de valores desconhecidos de escopo compartilhado. Essas informações são armazenadas como uma série de pares 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 no tipo apropriado e realizar um processamento adicional (como mapear 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 deriva de WebPart). Se um controle se marcar como "sujo", o conjunto de controle de Web Parts extrairá dados de personalização do controle, independentemente do estado "sujo" do controle, e o salvará de volta no armazenamento de dados subjacente mais adiante no ciclo de vida de personalização. Um controle deve se marcar como "sujo" se, como resultado do processamento dos valores no unknownProperties parâmetro, o estado do controle tiver sido alterado.
Observe que, se propriedades órfãs forem detectadas ao importar controles de Web Parts, esse método será chamado automaticamente.
