SqlMembershipProvider.ApplicationName Propriedade

Definição

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

Obtém ou define o nome da aplicação para armazenar e recuperar informações de membro.

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

String

O nome da aplicação para armazenar e recuperar informações de membros. O valor padrão é o ApplicationPath valor da propriedade para o atual Request.

Exceções

ArgumentException

Foi feita uma tentativa de definir a ApplicationName propriedade para uma cadeia vazia ou null.

ProviderException

Foi feita uma tentativa de definir a ApplicationName propriedade para uma cadeia de caracteres superior a 256 caracteres.

Exemplos

O seguinte exemplo de código mostra o elemento membership na secção system.web do ficheiro Web.config para uma aplicação ASP.NET. Especifica a instância da SqlMembershipProvider aplicação e define como ApplicationNameMyApplication.

<membership defaultProvider="SqlProvider" userIsOnlineTimeWindow="20">
  <providers>
    <add name="SqlProvider"
      type="System.Web.Security.SqlMembershipProvider"
      connectionStringName="SqlServices"
      enablePasswordRetrieval="true"
      enablePasswordReset="false"
      requiresQuestionAndAnswer="true"
      passwordFormat="Encrypted"
      applicationName="MyApplication" />
  </providers>
</membership>

Observações

O ApplicationName é usado pelo SqlMembershipProvider para agrupar informações do utilizador. Ao qualificar a informação do utilizador com um nome de aplicação, pode armazenar informação de várias aplicações numa única base de dados sem conflitos entre nomes de utilizador duplicados. Além disso, 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 com o applicationName atributo.

Se um valor não for especificado para o applicationName atributo no ficheiro de configuração da aplicação Web, então o ApplicationPath valor da propriedade para o primeiro pedido feito à aplicação é utilizado.

Caution

Como uma única instância padrão de fornecedor de membros é usada para todos os pedidos servidos por um HttpApplication objeto, pode ter múltiplos pedidos a executar 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. Recomendamos que evite escrever código para permitir que os utilizadores definam a ApplicationName propriedade, a menos que seja necessário. Um exemplo de uma aplicação em que pode ser necessário definir a ApplicationName propriedade é uma aplicação administrativa que gere dados de membros 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