PersonalizationProvider Classe

  • Referência

Definição

Namespace:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

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

public ref class PersonalizationProvider abstract : System::Configuration::Provider::ProviderBase
public abstract class PersonalizationProvider : System.Configuration.Provider.ProviderBase
type PersonalizationProvider = class
    inherit ProviderBase
Public MustInherit Class PersonalizationProvider
Inherits ProviderBase
Herança
Object
ProviderBase
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 a funcionalidade padrão usada pela WebPartPersonalization classe .

Notas aos Implementadores

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

As implementações de são firmemente acorredidas a implementações de porque alguns métodos de provedor de personalização retornam PersonalizationProvider PersonalizationState instâncias de PersonalizationState classes derivadas de . Para facilitar o desenvolvimento de provedores personalizados, a classe base inclui uma implementação padrão da lógica de personalização e da lógica de PersonalizationProvider serialização/desserialização que é usada diretamente pela WebPartPersonalization classe . Como resultado, a aplicação de um provedor personalizado exclusivamente com a finalidade de 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 para a página estão sendo operados. Se um caminho e um nome de usuário são passados para um método, os dados de personalização do usuário para a página devem ser agidos. No caso do , os dados compartilhados para o caminho especificado sempre devem ser 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 LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[]) for null .

Todos os outros métodos abstratos destinam-se a uso somente em aplicativos administrativos e não são usados pela infraestrutura Web Parts em tempo de operação. Para ver um exemplo de uma 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

Confira também