ProfileManager.ApplicationName Propriedade

Definição

Espaço de Nomes:
System.Web.Profile
Assemblagem:
System.Web.dll

Obtém ou define o nome da aplicação para a qual armazenar e recuperar a informação do perfil.

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 de Propriedade

String

O nome da aplicação para a qual armazenar e recuperar a informação do perfil.

Exemplos

O seguinte excerto do ficheiro de configuração mostra o elemento profile na secção system.web do ficheiro de Web.config para uma aplicação ASP.NET. Define o fornecedor de perfil padrão da aplicação para uma SqlProfileProvider instância e define o ApplicationName para MyApplication.

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

Observações

Utiliza ProfileManager a ApplicationName propriedade para associar informações de perfil a diferentes aplicações. Isto permite que múltiplas aplicações usem a mesma base de dados para armazenar informações do utilizador sem enfrentar conflitos entre utilizadores duplicados. Várias aplicações ASP.NET podem usar a mesma base de dados de utilizadores especificando o mesmo valor na propriedade ApplicationName. A ApplicationName propriedade pode ser definida programaticamente, ou pode ser definida declarativamente no ficheiro de configuração da aplicação Web usando o applicationName atributo.

Se não for especificado um valor para o atributo applicationName no ficheiro de configuração da aplicação Web, então os fornecedores de perfil incluídos no .NET Framework utilizam o valor da propriedade ApplicationVirtualPath para ASP.NET aplicações. Para aplicações não ASP.NET, o valor padrão é o valor da propriedade ModuleName, sem a extensão do ficheiro.

A ApplicationName propriedade expõe a SettingsProvider.ApplicationName propriedade do fornecedor de perfil padrão. O fornecedor de perfil por defeito é especificado usando o defaultProvider atributo do elemento de configuração do perfil . Se o perfil de utilizador contiver propriedades geridas por um fornecedor de perfil diferente do fornecedor predefinido, podem ser configurados com um nome de aplicação diferente. Para aceder ao nome da aplicação de um fornecedor de perfil diferente do fornecedor padrão, obtenha uma referência ao fornecedor de perfil que utiliza a Providers propriedade e aceda diretamente à ApplicationName propriedade desse fornecedor.

Caution

Como uma única instância de fornecedor de perfil por defeito é usada para todos os pedidos servidos por um HttpApplication objeto, pode haver múltiplos pedidos a executar-se simultaneamente e a tentar definir o valor da ApplicationName propriedade. A ApplicationName propriedade não é segura contra threads para múltiplas escritas, e alterar o valor da ApplicationName propriedade pode resultar em comportamentos inesperados para múltiplos utilizadores de uma aplicação. Recomenda-se que evite escrever código que permita aos utilizadores definir a ApplicationName propriedade, a menos que assim seja necessário. Um exemplo de uma aplicação onde pode ser necessário definir a ApplicationName propriedade é uma aplicação administrativa que gere dados de perfil para múltiplas aplicações. Tal aplicação deveria ser uma aplicação de utilizador único e não uma aplicação Web.

Aplica-se a

Ver também