Partager via

SqlMembershipProvider.ApplicationName Propriété

  • Référence

Définition

Espace de noms:
System.Web.Security
Assembly:
System.Web.dll

Obtient ou définit le nom de l'application pour laquelle stocker ou récupérer des informations d'appartenance.

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

Valeur de propriété

String

Nom de l'application pour laquelle stocker et récupérer des informations d'appartenance. La valeur par défaut est celle de la propriété ApplicationPath du Request en cours.

Exceptions

ArgumentException

Une tentative a eu lieu pour affecter une chaîne vide ou une valeur null à la propriété ApplicationName.

ProviderException

Une tentative a été exécutée pour définir la propriété ApplicationName sur une chaîne qui comprend plus de 256 caractères.

Exemples

L’exemple de code suivant montre l’élément d’appartenance dans la system.web section du fichier Web.config pour une application ASP.NET. Il spécifie l’instance de l’application SqlMembershipProvider et définit sur MyApplicationApplicationName .

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

Remarques

ApplicationName est utilisé par pour regrouper les SqlMembershipProvider informations utilisateur. En qualifiant les informations utilisateur avec un nom d’application, vous pouvez stocker des informations pour plusieurs applications dans une base de données unique sans rencontrer de conflits entre les noms d’utilisateur en double. En outre, plusieurs applications ASP.NET peuvent utiliser la même base de données utilisateur en spécifiant la même valeur dans la ApplicationName propriété . La ApplicationName propriété peut être définie par programmation, ou elle peut être définie de manière déclarative dans le fichier de configuration de l’application web avec l’attribut applicationName .

Si aucune valeur n’est spécifiée pour l’attribut dans le applicationName fichier de configuration de l’application web, la valeur de propriété ApplicationPath de la première requête adressée à l’application est utilisée.

Attention

Étant donné qu’une seule instance de fournisseur d’appartenance par défaut est utilisée pour toutes les demandes traitées par un HttpApplication objet, vous pouvez avoir plusieurs requêtes exécutées simultanément et tenter de définir la valeur de la ApplicationName propriété. La ApplicationName propriété n’est pas thread safe pour plusieurs écritures, et la modification de la valeur de la ApplicationName propriété peut entraîner un comportement inattendu pour plusieurs utilisateurs d’une application. Nous vous recommandons d’éviter d’écrire du code pour permettre aux utilisateurs de définir la ApplicationName propriété, sauf si vous le devez. Un exemple d’application où la définition de la ApplicationName propriété peut être nécessaire est une application administrative qui gère les données d’appartenance pour plusieurs applications. Une telle application doit être une application mono-utilisateur et non une application web.

S’applique à

Voir aussi