ProfileManager.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:
 static property System::String ^ ApplicationName { System::String ^ get(); void set(System::String ^ value); };

public static string ApplicationName { get; set; }

static member ApplicationName : string with get, set

Public Shared Property ApplicationName As String

Valor da propriedade

String

O nome do aplicativo para o qual armazenar e recuperar informações de perfil.

Exemplos

O trecho do arquivo de configuração a seguir mostra o elemento de perfil na seção system.web do arquivo Web.config para um aplicativo ASP.NET. Ele define o provedor de perfil padrão do aplicativo como uma SqlProfileProvider instância e define o ApplicationName como MyApplication.

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

Comentários

O ProfileManager usa a ApplicationName propriedade para associar informações de perfil a aplicativos diferentes. 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, os provedores de perfil incluídos no .NET Framework usarão o valor da ApplicationVirtualPath propriedade para aplicativos ASP.NET. Para aplicativos non-ASP.NET, o valor padrão é o valor da ModuleName propriedade, sem a extensão de arquivo.

A ApplicationName propriedade expõe a SettingsProvider.ApplicationName propriedade do provedor de perfil padrão. O provedor de perfil padrão é especificado usando o defaultProvider atributo do elemento de configuração de perfil . Se o perfil de usuário contiver propriedades gerenciadas por um provedor de perfil diferente do provedor padrão, ele poderá ser configurado com um nome de aplicativo diferente. Para acessar o nome do aplicativo de um provedor de perfil diferente do provedor padrão, obtenha uma referência ao provedor de perfil usando a Providers propriedade e acesse a ApplicationName propriedade do provedor diretamente.

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 você a exija. 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