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é est en cours d’exécution sur une page dans l’étendue User, les données de la propriété applicables à chaque utilisateur et celles applicables à tous les utilisateurs seront chargées et fusionnées. Dans ce cas, seules les données applicables à chaque utilisateur seront enregistrées lorsqu’une page est en cours d’exécution dans l’étendue User.

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 composants WebPart personnalisation et est étroitement intégrée à d’autres paramètres, y compris l’étendue dans laquelle la page, via le WebPartManager contrôle, s’exécute ; l’étendue associée à chaque propriété sur un contrôle; et la façon dont le contrôle a été ajouté à la page. Pour plus d’informations sur l’étendue de personnalisation, consultez composants WebPart Vue d’ensemble de la personnalisation.

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érentes zones de 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 affichent le contrôle, doivent être chargées. Selon les droits de l’utilisateur en cours d’exécution, ces données applicables à grande échelle 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 générales applicables (ou les données partagées) ne peuvent être consultées que sur le contrôle.

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