SqlPersonalizationProvider Classe
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.
Implementa um fornecedor de personalização que utiliza o Microsoft SQL Server.
public ref class SqlPersonalizationProvider : System::Web::UI::WebControls::WebParts::PersonalizationProviderpublic class SqlPersonalizationProvider : System.Web.UI.WebControls.WebParts.PersonalizationProvidertype SqlPersonalizationProvider = class
inherit PersonalizationProviderPublic Class SqlPersonalizationProvider
Inherits PersonalizationProvider- Herança
Observações
Esta classe define a funcionalidade necessária para um fornecedor de personalização que utiliza o Microsoft SQL Server. Um fornecedor de personalização carrega e armazena dados de personalização em nome de uma WebPartPersonalization instância. Esta classe implementa a lógica para ler e escrever em computadores a correr SQL Server, e também implementa todos os métodos abstratos definidos em PersonalizationProvider. Para mais informações sobre fornecedores de personalização, consulte PersonalizationProvider.
O design de dados para utilização da personalização de Web Parts com SQL Server baseia-se na existência de duas tabelas comuns de base de dados SQL e dos seus procedimentos armazenados de suporte, que são partilhados para a maioria das implementações de funcionalidades baseadas em SQL. Estas tabelas e vistas são instaladas e desinstaladas usando os seguintes scripts:
installpagepersonalization.sql - Instala as tabelas de personalização, vistas e procedimentos armazenados relacionados.
uninstallpagepersonalization.sql - Desinstala as tabelas de personalização, vistas e procedimentos armazenados relacionados.
É importante estar ciente de que a personalização falhará se a sua aplicação Web não correr ao nível de confiança padrão de Medium ou superior (pode definir níveis de confiança personalizados num ficheiro Web.config usando o <trust level="" /> elemento). As PersonalizationAdministration classes and SqlPersonalizationProvider verificam ambas o nível de confiança de Low quando são inicializadas. Se configurar a sua aplicação para correr a um nível de confiança de Low, e usar o fornecedor padrão SqlPersonalizationProvider para gerir os dados de personalização da sua aplicação, na primeira vez que a aplicação tentar aceder aos dados de personalização, falhará porque um processo worker ASP.NET a correr em Low trust não tem as permissões necessárias para aceder às várias classes no namespace System.Data.SqlClient.
Construtores
| Name | Description |
|---|---|
| SqlPersonalizationProvider() |
Inicializa uma nova instância da SqlPersonalizationProvider classe. |
Propriedades
| Name | Description |
|---|---|
| ApplicationName |
Obtém ou define o nome da aplicação para armazenar e recuperar informação de personalização. |
| Description |
Recebe uma descrição breve e amigável, adequada para exibição em ferramentas administrativas ou outras interfaces de utilizador (UIs). (Herdado de ProviderBase) |
| Name |
Recebe o nome amigável usado para se referir ao fornecedor durante a configuração. (Herdado de ProviderBase) |
Métodos
| Name | Description |
|---|---|
| CreateSupportedUserCapabilities() |
Devolve uma lista de WebPartUserCapability objetos que representam o conjunto de capacidades conhecidas usadas pelo conjunto de controlo Web Parts. (Herdado de PersonalizationProvider) |
| DetermineInitialScope(WebPartManager, PersonalizationState) |
Determina se o âmbito inicial da personalização deve ser Shared ou User o âmbito. (Herdado de PersonalizationProvider) |
| DetermineUserCapabilities(WebPartManager) |
Devolve um dicionário contendo WebPartUserCapability instâncias que representam as capacidades relacionadas com personalização da conta de utilizador atualmente em execução. (Herdado de PersonalizationProvider) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| FindState(PersonalizationScope, PersonalizationStateQuery, Int32, Int32, Int32) |
Devolve uma coleção contendo zero ou mais PersonalizationStateInfoobjetos derivados, com base no âmbito e parâmetros especificados. |
| GetCountOfState(PersonalizationScope, PersonalizationStateQuery) |
Devolve uma contagem do número de linhas no armazenamento de dados subjacente que existem para o parâmetro especificado |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| Initialize(String, NameValueCollection) |
Implementa os procedimentos de inicialização necessários para um fornecedor de personalização do Microsoft SQL Server. Este método não foi pensado para ser usado diretamente a partir do seu código. |
| LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[]) |
Carrega dados de personalização do armazenamento subjacente, com base nos parâmetros especificados. |
| LoadPersonalizationState(WebPartManager, Boolean) |
Carrega os dados brutos do armazenamento subjacente e converte esses dados num PersonalizationState objeto. (Herdado de PersonalizationProvider) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| ResetPersonalizationBlob(WebPartManager, String, String) |
Apaga os dados de personalização do armazenamento subjacente. |
| ResetPersonalizationState(WebPartManager) |
Reinicia os dados de personalização para o armazenamento de dados subjacente. (Herdado de PersonalizationProvider) |
| ResetState(PersonalizationScope, String[], String[]) |
Elimina a informação de estado de personalização do armazenamento de dados subjacente, com base nos parâmetros especificados. |
| ResetUserState(String, DateTime) |
Elimina os dados de personalização do utilizador do armazenamento subjacente, com base nos parâmetros especificados. |
| SavePersonalizationBlob(WebPartManager, String, String, Byte[]) |
Guarda os dados brutos de personalização para a base de dados subjacente do base de dados do Microsoft SQL Server. |
| SavePersonalizationState(PersonalizationState) |
Guarda os dados de personalização para um armazenamento de dados. (Herdado de PersonalizationProvider) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |