PersonalizationScope Énumération

Définition

Indique l’étendue de personnalisation d’un objet WebPartManager ou de l’étendue 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
PersonalizationScope

Champs

Nom Valeur Description
User 0

Lorsque vous faites référence à l’étendue WebPartManager du contrôle, User l’étendue 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 tous les 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é de contrôle WebPart, User l’étendue 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 Shared l’étendue. 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 toutes les données utilisateur 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.

Shared 1

Lorsque vous faites référence à l’étendue WebPartManager du contrôle, Shared l’étendue signifie que les données de personnalisation s’appliquent à tous les utilisateurs pour tous les contrôles personnalisables d’une page et sont également disponibles pour être enregistrées sur la page.
Lorsque vous faites référence à l’étendue associée à une propriété de contrôle De composants WebPart, Shared l’étendue indique que la propriété autorise normalement uniquement le chargement ou l’enregistrement de données associées à tous les utilisateurs.

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, 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 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é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 consultent le contrôle, doivent être chargées. En fonction des 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 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 élevé de la personnalisation, s’exécute dans l’une des deux étendues de personnalisation.

S’applique à