PersonalizationProvider Classe

Definição

Implementa a funcionalidade básica para um provedor de personalização.

public abstract class PersonalizationProvider : System.Configuration.Provider.ProviderBase
Herança
PersonalizationProvider
Derivado

Comentários

Essa é a classe base abstrata que define a funcionalidade necessária de um provedor de personalização. Um provedor de personalização carrega e armazena dados de personalização em nome de uma WebPartPersonalization instância.

A classe base define o comportamento padrão para vários métodos; somente os métodos que lidam especificamente com o armazenamento de dados subjacente são marcados como abstratos. Isso permite que um desenvolvedor escreva um provedor personalizado para interagir com um armazenamento de dados específico, sem a necessidade de implementar novamente a funcionalidade padrão usada pela WebPartPersonalization classe .

Notas aos Implementadores

Você pode derivar de PersonalizationProvider e fornecer implementações apenas para os métodos abstratos definidos nessa classe. Os métodos abstratos lidam especificamente com o salvamento e o carregamento de dados em um armazenamento de dados físico e com a administração do armazenamento de dados. Um provedor personalizado deve ser capaz de manipular informações de personalização de uma maneira que distingue Shared dados de User dados. Além disso, um provedor deve segmentar dados de personalização por página, bem como por aplicativo.

As implementações de PersonalizationProvider são fortemente acopladas a implementações de porque alguns métodos de PersonalizationState provedor de personalização retornam instâncias de PersonalizationStateclasses derivadas de . Para facilitar o desenvolvimento de provedores personalizados, a PersonalizationProvider classe base inclui uma implementação padrão da lógica de personalização e da lógica de serialização/desserialização que é usada diretamente pela WebPartPersonalization classe . Como resultado, a criação de um provedor personalizado apenas para trabalhar com um armazenamento de dados diferente requer apenas a implementação dos seguintes métodos abstratos:

Em todos esses métodos, se apenas um caminho for fornecido, isso indicará que os dados de personalização compartilhados da página estão sendo operados. Se um caminho e um nome de usuário forem passados para um método, os dados de personalização do usuário para a página deverão ser tratados. No caso de LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[]), os dados compartilhados do caminho especificado devem ser sempre carregados e, opcionalmente, os dados de personalização do usuário para o caminho também deverão ser carregados se o nome de usuário não nullfor .

Todos os outros métodos abstratos destinam-se a serem usados somente em aplicativos administrativos e não são usados pela infraestrutura de Web Parts em tempo de execução. Para obter um exemplo de implementação de um provedor de personalização, consulte a SqlPersonalizationProvider classe .

Construtores

PersonalizationProvider()

Inicializa uma nova instância da classe PersonalizationProvider.

Propriedades

ApplicationName

Quando substituído em uma classe derivada, obtém ou define o nome do aplicativo configurado para o provedor.

Description

Obtém uma breve descrição amigável adequada para exibição em ferramentas administrativas ou outras IUs (interfaces do usuário).

(Herdado de ProviderBase)
Name

Obtém o nome amigável usado para referir-se ao provedor durante a configuração.

(Herdado de ProviderBase)

Métodos

CreateSupportedUserCapabilities()

Retorna uma lista de objetos WebPartUserCapability que representam o conjunto de funcionalidades conhecidas usado pelo conjunto de controles de Web Parts.

DetermineInitialScope(WebPartManager, PersonalizationState)

Determina se o escopo de personalização inicial deve ser o escopo Shared ou User.

DetermineUserCapabilities(WebPartManager)

Retorna um dicionário que contém instâncias WebPartUserCapability que representam as funcionalidades relacionadas à personalização da conta de usuário em execução no momento.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
FindState(PersonalizationScope, PersonalizationStateQuery, Int32, Int32, Int32)

Quando substituído em uma classe derivada, retorna uma coleção que contém zero ou mais objetos derivados de PersonalizationStateInfo com base no escopo e nos parâmetros de consulta específicos.

GetCountOfState(PersonalizationScope, PersonalizationStateQuery)

Quando substituído em uma classe derivada, retorna o número de linhas no armazenamento de dados subjacente que existe dentro do escopo especificado.

GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
Initialize(String, NameValueCollection)

Inicializa o construtor de configuração.

(Herdado de ProviderBase)
LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[])

Quando substituído em uma classe derivada, carrega os dados brutos de personalização do armazenamento de dados subjacente.

LoadPersonalizationState(WebPartManager, Boolean)

Carrega os dados brutos do armazenamento de dados subjacente e converte esses dados em um objeto PersonalizationState.

MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ResetPersonalizationBlob(WebPartManager, String, String)

Quando substituído em uma classe derivada, exclui os dados brutos de personalização do armazenamento de dados subjacente.

ResetPersonalizationState(WebPartManager)

Redefine os dados de personalização para o armazenamento de dados subjacente.

ResetState(PersonalizationScope, String[], String[])

Quando substituído em uma classe derivada, exclui o estado de personalização do armazenamento de dados subjacente com base nos parâmetros especificados.

ResetUserState(String, DateTime)

Quando substituído em uma classe derivada, exclui os dados de personalização de Web Parts do armazenamento de dados subjacente com base nos parâmetros especificados.

SavePersonalizationBlob(WebPartManager, String, String, Byte[])

Quando substituído em uma classe derivada, salva os dados brutos de personalização no armazenamento de dados subjacente.

SavePersonalizationState(PersonalizationState)

Salva os dados de personalização em um armazenamento de dados.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Produto Versões
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Confira também