Roles.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 laquelle stocker ou récupérer des informations de rôle.

public:
 static property System::String ^ ApplicationName { System::String ^ get(); void set(System::String ^ value); };

public static string ApplicationName { get; set; }

static member ApplicationName : string with get, set

Public Shared Property ApplicationName As String

Valeur de propriété

String

Nom de l'application pour laquelle stocker et récupérer des informations de rôle.

Exemples

L’exemple suivant montre l’élément roleManager dans la system.web section du fichier Web.config pour une application ASP.NET. Il spécifie que l’application utilise une SqlRoleProvider instance et définit l’attribut applicationName sur MyApplication.

<roleManager defaultProvider="SqlProvider"
  enabled="true"
  cacheRolesInCookie="true"
  cookieName=".ASPROLES"
  cookieTimeout="30"
  cookiePath="/"
  cookieRequireSSL="false"
  cookieSlidingExpiration="true"
  cookieProtection="All" >
  <providers>
    <add
      name="SqlProvider"
      type="System.Web.Security.SqlRoleProvider"
      connectionStringName="SqlServices"
      applicationName="MyApplication" />
  </providers>
</roleManager>

Remarques

La ApplicationName propriété est utilisée par la Roles classe pour associer des utilisateurs et des rôles à différentes applications. Cela permet à plusieurs applications d’utiliser la même source de données pour stocker les informations d’utilisateur et de rôle sans créer de conflits entre des noms d’utilisateurs en double ou des noms de rôles en double. Plusieurs applications ASP.NET peuvent utiliser la même source de données en spécifiant la même valeur dans la ApplicationName propriété . Vous pouvez définir la ApplicationName propriété par programmation, ou vous pouvez la définir de manière déclarative dans le fichier de configuration de l’application web à l’aide de l’attribut applicationName .

Si votre application web utilise la SqlRoleProvider classe et qu’aucune valeur n’est spécifiée pour l’attribut applicationName dans le fichier de configuration, la valeur de propriété HttpRequest.ApplicationPath de la propriété actuelle HttpContext.Request est utilisée.

Attention

Étant donné qu’une seule instance de fournisseur de rôle par défaut est utilisée pour toutes les demandes traitées par un HttpApplication objet, vous pouvez avoir plusieurs requêtes s’exécutant simultanément et en essayant 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 propriété ApplicationName peut entraîner un comportement inattendu pour plusieurs utilisateurs d’une application. Vous devez éviter d’écrire du code pour permettre aux utilisateurs de définir la ApplicationName propriété, sauf si nécessaire. Une application administrative qui gère les données de rôle pour plusieurs applications est un exemple d’application où la définition de la ApplicationName propriété peut être requise. Une telle application doit être une application mono-utilisateur et non une application web.

Voir aussi

• Présentation de la gestion des rôles ASP.NET