SqlMembershipProvider.ApplicationName Propriedade

Definição

Namespace:

System.Web.Security

Assembly:

System.Web.dll

Obtém ou define o nome do aplicativo para o qual armazenar e recuperar informações de associação.

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

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

ProviderException

Foi feita uma tentativa de definir a ApplicationName propriedade como uma cadeia de caracteres com mais de 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 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>

Comentários

O ApplicationName é usado pelas informações do usuário para agrupar SqlMembershipProvider . Ao qualificar 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 executar 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 sendo executadas 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 de ASP.NET