SqlMembershipProvider.ApplicationName Propriedade

Definição

Namespace:

System.Web.Security

Assembly:

System.Web.dll

Obtém ou define o nome do aplicativo do qual as informações de associação 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 associação. O padrão é o valor da ApplicationPath propriedade para o atual Request.

Exceções

ArgumentException

Ocorreu uma tentativa de definir a propriedade ApplicationName para uma cadeia de caracteres vazia ou null.

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 elemento de associação na system.web seção do arquivo Web.config para um aplicativo ASP.NET. Ele especifica a instância do SqlMembershipProvider aplicativo e define o ApplicationName como MyApplication.

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

Comentários

O ApplicationName é usado pelo para agrupar informações do SqlMembershipProvider usuário. Ao qualificar as 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 ter 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 com o applicationName atributo .

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

Cuidado

Como uma única instância de provedor de associação 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. Recomendamos que você evite escrever 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 definição da ApplicationName propriedade pode ser necessária é um aplicativo administrativo que gerencia dados de associação para vários aplicativos. Esse aplicativo deve ser um aplicativo de usuário único e não um aplicativo Web.

Confira também

• Introdução à associação ASP.NET