SqlProfileProvider.ApplicationName Propriedade

Definição

Namespace:

System.Web.Profile

Assembly:

System.Web.dll

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

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 perfil. O padrão é o valor ApplicationVirtualPath.

Exceções

HttpException

Foi feita uma tentativa de definir a propriedade ApplicationName por um chamador que não tem a permissão de hospedagem do ASP.NET High.

ProviderException

Foi feita uma tentativa de definir a propriedade ApplicationName como uma cadeia de caracteres maior do que 256 caracteres.

Exemplos

O exemplo de código a seguir mostra o profile elemento na system.web seção do arquivo Web.config para um aplicativo ASP.NET. Ele especifica a instância do aplicativo e define o valor da SqlProfileProviderApplicationName propriedade como MyApplication.

<profile defaultProvider="SqlProvider">  
  <providers>  
    <add name="SqlProvider"  
      type="System.Web.Profile.SqlProfileProvider"  
      connectionStringName="SqlServices"  
      applicationName="MyApplication" />  
   </providers>  
</profile>  

Comentários

A ApplicationName propriedade é usada pelo SqlProfileProvider para associar informações de perfil a diferentes aplicativos. Isso permite que vários aplicativos usem o mesmo banco de dados para armazenar informações do usuário sem encontrar conflitos entre usuários duplicados. 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 .

Se um valor não for especificado para o applicationName atributo no arquivo de configuração do aplicativo Web, o ApplicationVirtualPath valor será usado para ASP.NET aplicativos. Para aplicativos non-ASP.NET, o valor padrão é o ModuleName valor sem a extensão de arquivo.

Cuidado

Como uma única instância de provedor de perfil padrão é usada para todas as solicitações atendidas por um HttpApplication objeto , você pode ter várias solicitações em execução 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 escrever código que permita 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 perfil para vários aplicativos. Esse aplicativo deve ser um aplicativo de usuário único e não um aplicativo Web.

Confira também

• Visão geral das propriedades do perfil ASP.NET