PersonalizationScope Énumération
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 PersonalizationScopepublic enum PersonalizationScopetype PersonalizationScope = Public Enum PersonalizationScope- Héritage
Champs
| Shared | 1 | Lorsqu'elle fait référence à la portée sur le contrôle WebPartManager, la portée |
| User | 0 | Quand il est fait référence à l’étendue sur le contrôle WebPartManager, 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.
