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 lequel stocker et récupérer des informations de personnalisation.

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 la ApplicationVirtualPath valeur de propriété pour le fichier actif Request.

Exceptions

ProviderException

La propriété a été définie sur une chaîne dont la longueur est supérieure à 256 caractères.

Remarques

La ApplicationName propriété est utilisée par la SqlPersonalizationProvider classe pour regrouper les informations utilisateur. 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 à l’aide de l’attribut applicationName de la <providers> section.

Si une valeur n’est pas spécifiée pour l’attribut dans le applicationName fichier de configuration de l’application web, la ApplicationVirtualPath 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 de personnalisation 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 propriété ApplicationName peut entraîner un comportement inattendu pour plusieurs utilisateurs d’une application. Il est recommandé d’éviter le code pour permettre aux utilisateurs de définir la ApplicationName propriété, sauf si nécessaire. 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 de personnalisation pour plusieurs applications. Une telle application doit être une application mono-utilisateur et non une application web.