PersonalizationProvider Classe
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.
Implementa a funcionalidade básica para um provedor de personalização.
public ref class PersonalizationProvider abstract : System::Configuration::Provider::ProviderBasepublic abstract class PersonalizationProvider : System.Configuration.Provider.ProviderBasetype PersonalizationProvider = class
inherit ProviderBasePublic MustInherit Class PersonalizationProvider
Inherits ProviderBase- Herança
- 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 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 são PersonalizationProvider fortemente acopladas a implementações porque alguns métodos de PersonalizationState provedor de personalização retornam instâncias de PersonalizationStateclasses derivadas. 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 com a finalidade de trabalhar com um repositório de dados diferente requer apenas a implementação dos seguintes métodos abstratos:
GetCountOfState(PersonalizationScope, PersonalizationStateQuery) - Esse método precisa ser capaz de contar o número de linhas de dados de personalização no banco de dados para os parâmetros de consulta fornecidos.
LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[]) – Considerando o caminho e o nome de usuário, esse método carrega dois BLOBs (objetos binários grandes) do banco de dados: um BLOB para dados compartilhados e outro para dados do usuário. Se você fornecer o nome de usuário e o caminho, não precisará do WebPartManager controle para acessar as informações da página que podem fornecer as informações de nome de usuário/caminho.
ResetPersonalizationBlob(WebPartManager, String, String) – Dado o caminho e o nome de usuário, esse método exclui a linha correspondente no banco de dados. Se você fornecer o nome de usuário e o caminho, não precisará do WebPartManager controle para acessar as informações da página que podem fornecer as informações de nome de usuário/caminho.
SavePersonalizationBlob(WebPartManager, String, String, Byte[]) - Dado o caminho e o nome de usuário, esse método salva o BLOB fornecido no banco de dados. Se você fornecer o nome de usuário e o caminho, não precisará do WebPartManager controle para acessar as informações da página que podem fornecer as informações de nome de usuário/caminho.
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 sempre devem ser carregados e, opcionalmente, os dados de personalização do usuário para o caminho também devem ser carregados se o nome de usuário não nullfor .
Todos os outros métodos abstratos destinam-se ao uso 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 uma implementação de um provedor de personalização, consulte a SqlPersonalizationProvider classe.
Construtores
| Nome | Description |
|---|---|
| PersonalizationProvider() |
Inicializa uma nova instância da classe PersonalizationProvider. |
Propriedades
| Nome | Description |
|---|---|
| ApplicationName |
Quando substituído em uma classe derivada, obtém ou define o nome do aplicativo configurado para o provedor. |
| Description |
Obtém uma descrição breve e amigável adequada para exibição em ferramentas administrativas ou em outras interfaces de usuário (UIs). (Herdado de ProviderBase) |
| Name |
Obtém o nome amigável usado para se referir ao provedor durante a configuração. (Herdado de ProviderBase) |
Métodos
| Nome | Description |
|---|---|
| CreateSupportedUserCapabilities() |
Retorna uma lista de WebPartUserCapability objetos que representam o conjunto de recursos conhecidos usados pelo conjunto de controle de Web Parts. |
| DetermineInitialScope(WebPartManager, PersonalizationState) |
Determina se o escopo de personalização inicial deve ser Shared ou User o escopo. |
| DetermineUserCapabilities(WebPartManager) |
Retorna um dicionário que WebPartUserCapability contém instâncias que representam os recursos relacionados à 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 PersonalizationStateInfoobjetos derivados com base no escopo e em 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 existem 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ções. (Herdado de ProviderBase) |
| LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[]) |
Quando substituído em uma classe derivada, carrega 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 PersonalizationState objeto. |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| ResetPersonalizationBlob(WebPartManager, String, String) |
Quando substituído em uma classe derivada, exclui dados brutos de personalização do armazenamento de dados subjacente. |
| ResetPersonalizationState(WebPartManager) |
Redefine 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 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 dados brutos de personalização no armazenamento de dados subjacente. |
| SavePersonalizationState(PersonalizationState) |
Salva dados de personalização em um armazenamento de dados. |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
