Partager via

SqlMembershipProvider.ApplicationName Propriété

Définition

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

Obtient ou définit le nom de l’application pour lequel stocker et 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 les informations d’appartenance. La valeur par défaut est la ApplicationPath valeur de propriété pour le fichier actif Request.

Exceptions

ArgumentException

Une tentative a été effectuée pour définir la ApplicationName propriété sur une chaîne vide ou null.

ProviderException

Une tentative a été effectuée pour définir la ApplicationName propriété sur une chaîne supérieure à 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. Elle spécifie l’instance de l’application SqlMembershipProvider et définit la valeur 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>

Remarques

Il ApplicationName est utilisé par les informations utilisateur de SqlMembershipProvider groupe. En sélectionnant les informations utilisateur avec un nom d’application, vous pouvez stocker des informations pour plusieurs applications dans une base de données unique sans entrer en conflit entre les noms d’utilisateurs dupliqués. 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 une valeur n’est pas spécifiée pour l’attribut dans le applicationName fichier de configuration de l’application web, la ApplicationPath valeur de propriété pour la première requête adressée à l’application est utilisée.

Avertissement

Étant donné qu’une seule instance de fournisseur d’appartenance par défaut est utilisée pour toutes les requêtes traitées par un HttpApplication objet, vous pouvez avoir plusieurs requêtes s’exécutant simultanément et tenter de définir la valeur de propriété ApplicationName . 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 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