SqlPersonalizationProvider.ApplicationName Propriedade

Definição

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Obtém ou define o nome do aplicativo para o qual serão armazenadas e recuperadas informações de personalização.

public:
 virtual property System::String ^ ApplicationName { System::String ^ get(); void set(System::String ^ value); };

public override string ApplicationName { get; set; }

member this.ApplicationName : string with get, set

Public Overrides Property ApplicationName As String

Valor da propriedade

String

O nome do aplicativo para o qual armazenar e recuperar informações de personalização. O padrão é o valor da ApplicationVirtualPath propriedade para o atual Request.

Exceções

ProviderException

A propriedade foi definida como uma cadeia de caracteres com mais de 256 caracteres.

Comentários

A ApplicationName propriedade é usada pela classe para agrupar informações do SqlPersonalizationProvider usuário. Ao qualificar informações do usuário com um nome de aplicativo, você pode armazenar informações para vários aplicativos em um único banco de dados sem entrar em conflitos entre nomes de usuário duplicados. Além disso, vários aplicativos ASP.NET podem usar o mesmo banco de dados de usuário especificando o mesmo valor na ApplicationName propriedade. A ApplicationName propriedade pode ser definida programaticamente ou pode ser definida declarativamente no arquivo de configuração do aplicativo Web usando o applicationName atributo na <providers> seção.

Se um valor não for especificado para o applicationName atributo no arquivo de configuração do aplicativo Web, o valor da ApplicationVirtualPath propriedade da primeira solicitação feita ao aplicativo será usado.

Cuidado

Como uma única instância de provedor de personalização padrão é usada para todas as solicitações atendidas por um HttpApplication objeto, você pode ter várias solicitações sendo executadas simultaneamente e tentando definir o valor da ApplicationName propriedade. A ApplicationName propriedade não é thread-safe para várias gravações e alterar o valor da ApplicationName propriedade pode resultar em um comportamento inesperado para vários usuários de um aplicativo. É recomendável evitar o código para permitir que os usuários definam a ApplicationName propriedade, a menos que seja necessário. Um exemplo de um aplicativo em que a configuração da ApplicationName propriedade pode ser necessária é um aplicativo administrativo que gerencia dados de personalização para vários aplicativos. Esse aplicativo deve ser um aplicativo de usuário único e não um aplicativo Web.