PersonalizationScope Énumération

Définition

Espace de noms:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Indique la portée de personnalisation pour un objet WebPartManager ou la portée de personnalisation qui s'applique à une propriété sur un contrôle WebPart.

public enum class PersonalizationScope

public enum PersonalizationScope

type PersonalizationScope = 

Public Enum PersonalizationScope

Héritage

Object

ValueType

Enum

PersonalizationScope

Champs

Shared	1	Lorsqu'elle fait référence à la portée sur le contrôle WebPartManager, la portée Shared signifie que les données de personnalisation s'appliquent à l'ensemble des utilisateurs de tous les contrôles personnalisables d'une page et peuvent également être enregistrées sur la page. Lorsque vous faites référence à l’étendue associée à une propriété du contrôle WebPart, l’étendue Shared indique que la propriété autorise normalement uniquement le chargement ou l’enregistrement de données associées à tous les utilisateurs.
User	0	Quand il est fait référence à l’étendue sur le contrôle WebPartManager, l’étendue User signifie que les données de personnalisation spécifiques à l'utilisateur, ainsi que les données de personnalisation qui s'appliquent à tous les utilisateurs, sont chargées pour l'ensemble des contrôles personnalisables d'une page. Seules les données de personnalisation spécifiques à l'utilisateur peuvent être enregistrées sur la page. Lorsque vous faites référence à l’étendue associée à une propriété du contrôle WebPart, l’étendue User indique que la propriété peut uniquement charger et stocker des données applicables à tous les utilisateurs lors de l’exécution sur une page dans l’étendue Shared. Toutefois, lorsque le contrôle de la propriété s’exécute sur une page dans User l’étendue, les données par utilisateur et tous les utilisateurs de la propriété sont chargées et fusionnées. Dans ce cas, toutefois, seules les données par utilisateur sont enregistrées lorsqu’une page s’exécute dans User l’étendue de l’étendue.

Exemples

L’exemple suivant illustre l’utilisation de l’énumération PersonalizationScope :

if (_manager.Personalization.Scope == PersonalizationScope.Shared)
{
    TextBox2.Text = "Shared Scope";
}
else
    TextBox2.Text = "User Scope";

Remarques

L’étendue de personnalisation est un concept clé dans la personnalisation des composants WebPart et est étroitement intégrée à d’autres paramètres, notamment l’étendue dans laquelle la page, via le WebPartManager contrôle, s’exécute ; l’étendue associée à chaque propriété d’un contrôle et la façon dont le contrôle a été ajouté à la page. Pour plus d’informations sur l’étendue de la personnalisation, consultez Vue d’ensemble de la personnalisation des composants WebPart.

L’étendue de personnalisation fait référence à la façon dont les données de personnalisation s’appliquent à différents ensembles d’utilisateurs. Certaines données de personnalisation s’appliquent uniquement à un utilisateur et à un contrôle spécifiques sur une page. D’autres données de personnalisation s’appliquent à tous les utilisateurs qui affichent un site. L’étendue de personnalisation est utilisée dans différents domaines de la personnalisation pour indiquer quel ensemble de données doit être récupéré et affiché.

Lorsqu’une page s’exécute dans Shared l’étendue de personnalisation, cela indique que seules les données de personnalisation d’un contrôle spécifique, applicables à tous les utilisateurs qui consultent le contrôle, doivent être chargées. En fonction des droits de l’utilisateur en cours d’exécution, ces données largement applicables peuvent également être modifiées et enregistrées dans le magasin de données. Lorsqu’une page s’exécute dans User l’étendue de personnalisation, cela indique que les données de personnalisation d’un contrôle doivent être enregistrées et chargées en fonction de l’utilisateur en cours d’exécution. En règle générale, cela signifie que les données spécifiques à l’utilisateur peuvent être chargées et enregistrées sur un contrôle, tandis que les données largement applicables (ou les données partagées) peuvent uniquement être consultées sur le contrôle.

Un WebPartManager contrôle, qui gère le cycle de vie de haut niveau de la personnalisation, s’exécute dans l’une des deux étendues de personnalisation.