PersonalizationScope Énumération

Définition

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.Indicates the personalization scope for a WebPartManager object or the personalization scope that applies to a property on a Web Parts control.

public enum class PersonalizationScope
public enum PersonalizationScope
type PersonalizationScope = 
Public Enum PersonalizationScope
Héritage
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.When referring to the scope on the WebPartManager control, Shared scope means that personalization data applies to all users for all personalizable controls on a page and is also available to be saved on the 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.When referring to the scope associated with a Web Parts control property, Shared scope indicates that the property normally only allows loading or saving of data associated with all users.

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.When referring to the scope on the WebPartManager control, User scope means that personalization data that is user-specific, as well as personalization data that applies to all users, is loaded for all personalizable controls on a page. Seules les données de personnalisation spécifiques à l'utilisateur peuvent être enregistrées sur la page.Only personalization data that is user-specific can be saved on the 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.When referring to the scope associated with a Web Parts control property, User scope indicates that the property can only load and store data applicable to all users when running on a page in Shared scope. 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.However, when the property's control is running on a page in User scope, the property's per-user and all-user data will be loaded and merged. 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.In this case, though, only per-user data will be saved when a page is running in User scope scope.

Exemples

L’exemple suivant illustre l’utilisation PersonalizationScope de l’énumération:The following example demonstrates using the PersonalizationScope enumeration:

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

Remarques

La portée de personnalisation est un concept clé dans composants WebPart personnalisation et est étroitement intégrée à d’autres paramètres, notamment à l’étendue de l’exécution WebPartManager de la page, du contrôle, de l’étendue associée à chaque propriété sur un contrôle; et de la façon dont dans laquelle le contrôle a été ajouté à la page.Personalization scope is a key concept in Web Parts personalization and is tightly integrated with other settings, including the scope that the page, through the WebPartManager control, is running in; the scope associated with each property on a control; and the way in which the control was added to the page. Pour plus d’informations sur la portée de personnalisation, consultez composants WebPart vue d’ensemblede la personnalisation.For more information on personalization scope, see Web Parts Personalization Overview.

La portée de personnalisation fait référence à la façon dont les données de personnalisation sont applicables aux différents groupes d’utilisateurs.Personalization scope refers to how personalization data is applicable to different sets of users. Certaines données de personnalisation sont applicables uniquement à un utilisateur spécifique et à un contrôle sur une page.Some personalization data is applicable to only a specific user and control on a page. D’autres données de personnalisation sont applicables à tous les utilisateurs qui affichent un site.Other personalization data is applicable to all users who view a site. La portée de personnalisation est utilisée dans différents domaines de personnalisation pour indiquer quel jeu de données doit être récupéré et affiché.Personalization scope is used in various areas of personalization to indicate which set of data should be retrieved and displayed.

Quand une page s’exécute dans Shared une portée de personnalisation, cela indique que seules les données de personnalisation d’un contrôle spécifique, applicables à tous les utilisateurs qui visualisent le contrôle, doivent être chargées.When a page is running in Shared personalization scope, this indicates that only the personalization data for a specific control, applicable to all users viewing the control, should be loaded. 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.Depending on the currently executing user's rights, this broadly applicable data can also be modified and saved back to the data store. Quand une page s’exécute dans User une portée 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.When a page is running in User personalization scope, this indicates that a control's personalization data should be saved and loaded based on the currently executing user. 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, alors que des données largement applicables (ou des données partagées) peuvent uniquement être affichées sur le contrôle.Usually, this means user-specific data can be loaded and saved on a control, while broadly applicable data (or shared data) can only be viewed on the control.

Un WebPartManager contrôle, qui gère le cycle de vie de la personnalisation de haut niveau, s’exécute dans l’une des deux portées de personnalisation.A WebPartManager control, which manages the high-level life cycle of personalization, executes in one of the two personalization scopes.

S’applique à