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 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:
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[]) – Dado 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 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) |
