SqlPersonalizationProvider.ApplicationName Propriété

Définition

Espace de noms:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Obtient ou définit le nom de l'application pour laquelle les informations de personnalisation doivent être stockées et récupérées.

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 de personnalisation. La valeur par défaut est celle de la propriété ApplicationVirtualPath du Request en cours.

Exceptions

ProviderException

La propriété a été définie avec une valeur de type chaîne d'une longueur supérieure à 256 caractères.

Remarques

La ApplicationName propriété est utilisée par la SqlPersonalizationProvider classe pour regrouper les 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’utilisateurs 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 de manière déclarative dans le fichier de configuration de l’application web à l’aide de l’attribut applicationName de la <providers> section .

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

Attention

Étant donné qu’une seule instance de fournisseur de personnalisation par défaut est utilisée pour toutes les demandes traitées par un HttpApplication objet, plusieurs requêtes peuvent s’exécuter 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 propriété ApplicationName peut entraîner un comportement inattendu pour plusieurs utilisateurs d’une application. Il est recommandé d’éviter le code pour autoriser les utilisateurs à définir la ApplicationName propriété, sauf si nécessaire. Une application administrative qui gère les données de personnalisation pour plusieurs applications est un exemple d’application dans laquelle 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.