IVersioningPersonalizable.Load(IDictionary) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Carrega dados de personalização para um controlo de Web Parts que não possui 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 podia ser aplicado a um controlo.
Observações
O unknownProperties parâmetro contém uma representação fundida de dados de personalização desconhecidos, tanto do âmbito "Utilizador" como do "Partilhado", que não podiam ser aplicados ao controlo. Quando uma página está a correr no âmbito do utilizador, os valores desconhecidos do âmbito do utilizador são fornecidos (se disponíveis) em vez dos valores desconhecidos do âmbito partilhado. Esta informação é armazenada como uma série de pares nome/valor onde cada nome é o nome da cadeia de uma propriedade que não foi encontrada no controlo e cada valor contém o valor da propriedade. É responsabilidade do controlo castar ou converter o valor para o tipo apropriado e realizar processamento adicional (como mapear dados de uma propriedade antiga para uma nova).
Se o estado de um controlo mudar, deve chamar SetPersonalizationDirty (ou o método herdado, ou o método público estático no caso de um controlo que não deriva de WebPart). Se um controlo se marcar como "sujo", o conjunto de controlos Web Parts irá extrair dados de personalização do controlo, independentemente do estado "sujo" do controlo, e guardá-los de volta para o armazenamento de dados subjacente mais tarde no ciclo de vida da personalização. Um controlo deve marcar-se como "sujo" se, como resultado do processamento dos valores no unknownProperties parâmetro, o estado do controlo tiver mudado.
Note que, se propriedades órfãs forem detetadas ao importar controlos de Web Parts, este método é automaticamente chamado.
