Roles.ApplicationName Propriété

Définition

Obtient ou définit le nom de l'application pour laquelle stocker ou récupérer des informations de rôle.Gets or sets the name of the application to store and retrieve role information for.

public:
 static property System::String ^ ApplicationName { System::String ^ get(); void set(System::String ^ value); };
public static string ApplicationName { get; set; }
member this.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.The name of the application to store and retrieve role information for.

Exemples

L’exemple suivant montre l’élément roleManager dans la system.web section du fichier Web.config pour une application ASP.net.The following example shows the roleManager element in the system.web section of the Web.config file for an ASP.NET application. Il spécifie que l’application utilise une SqlRoleProvider instance et affecte applicationName à l’attribut la valeur MyApplication .It specifies that the application uses a SqlRoleProvider instance and sets the applicationName attribute to 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 à des applications différentes.The ApplicationName property is used by the Roles class to associate users and roles with different 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 rencontrer de conflits entre des noms d’utilisateur en double ou des noms de rôles dupliqués.This enables multiple applications to use the same data source to store user and role information without running into conflicts between duplicate user names or duplicate role names. 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é.Multiple ASP.NET applications can use the same data source by specifying the same value in the ApplicationName property. 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 pour l’application Web à l’aide de l' applicationName attribut.You can set the ApplicationName property programmatically, or you can set it declaratively in the configuration file for the Web application by using the applicationName attribute.

Si votre application Web utilise la SqlRoleProvider classe et qu’aucune valeur n’est spécifiée pour l' applicationName attribut dans le fichier de configuration, la HttpRequest.ApplicationPath valeur de propriété de la HttpContext.Request propriété actuelle est utilisée.If your Web application is using the SqlRoleProvider class and a value is not specified for the applicationName attribute in the configuration file, the HttpRequest.ApplicationPath property value for the current HttpContext.Request property is used.

Attention

Étant donné qu’une seule instance de fournisseur de rôles par défaut est utilisée pour toutes les requêtes traitées par un HttpApplication objet, plusieurs requêtes peuvent s’exécuter simultanément et tenter de définir la ApplicationName valeur de la propriété.Because a single default role provider instance is used for all of the requests served by an HttpApplication object, you can have multiple requests executing concurrently and attempting to set the ApplicationName property value. La ApplicationName propriété n’est pas thread-safe pour plusieurs écritures, et la modification de la ApplicationName valeur de propriété peut entraîner un comportement inattendu pour plusieurs utilisateurs d’une application.The ApplicationName property is not thread safe for multiple writes, and changing the ApplicationName property value can result in unexpected behavior for multiple users of an application. Vous devez éviter d’écrire du code pour permettre aux utilisateurs de définir la ApplicationName propriété, sauf si cela est nécessaire.You should avoid writing code to allow users to set the ApplicationName property, unless required. Une application ApplicationName administrative qui gère des données de rôle pour plusieurs applications est un exemple d’application dans laquelle la définition de la propriété peut être requise.An example of an application where setting the ApplicationName property may be required is an administrative application that manages role data for multiple applications. Une telle application doit être une application à utilisateur unique et non une application Web.Such an application should be a single-user application and not a Web application.

S’applique à