PersonalizationScope Перечисление

Определение

Указывает область персонализации для объекта WebPartManager или область персонализации, применяемую к свойству элемента управления веб-частей.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
Наследование
PersonalizationScope

Поля

Shared 1

Когда речь идет об области для элемента управления WebPartManager, область Shared означает, что данные персонализации применяются ко всем пользователям для всех элементов управления, поддерживающих персонализацию, на странице, а также могут сохраняться на странице.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.
Ссылаясь на область, связанную со свойством элемента управления веб-частей, область Shared указывает, что свойство обычно разрешает только загрузку и сохранение данных, связанных со всеми пользователями.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

Когда речь идет об области для элемента управления WebPartManager, область User означает, что для всех элементов управления на странице, поддерживающих персонализацию, загружаются данные персонализации для отдельных пользователей, а также данные персонализации, применяемые ко всем пользователям.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. На странице могут сохраняться только данные персонализации, относящиеся к отдельным пользователям.Only personalization data that is user-specific can be saved on the page.
Ссылаясь на область, связанную со свойством элемента управления веб-частей, область User указывает, что свойство обычно разрешает только загрузку и сохранение данных, связанных со всеми пользователями, при выполнении на странице в области 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. При этом, если элемент управления свойства выполняется на странице в области User, свойства данных определенного пользователя и всех пользователей будут загружаться и объединяться.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. Но в этом случае только данные пользователя будут сохраняться при выполнении страницы в области User.In this case, though, only per-user data will be saved when a page is running in User scope scope.

Примеры

В следующем примере демонстрируется использование PersonalizationScope перечисления.The following example demonstrates using the PersonalizationScope enumeration:

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

Комментарии

Область персонализации является ключевой концепцией веб-части персонализации и тесно интегрирована с другими параметрами, включая область, в которой выполняется страница, через WebPartManager элемент управления, область, связанная с каждым свойством элемента управления, и способ, которым элемент управления был добавлен на страницу.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. Дополнительные сведения о области персонализации см. в разделе Общие сведения о персонализации веб-части.For more information on personalization scope, see Web Parts Personalization Overview.

Область персонализации означает, как данные персонализации применимы к разным наборам пользователей.Personalization scope refers to how personalization data is applicable to different sets of users. Некоторые данные персонализации применимы только для определенного пользователя и управления на странице.Some personalization data is applicable to only a specific user and control on a page. Другие данные персонализации применимы для всех пользователей, просматривающих сайт.Other personalization data is applicable to all users who view a site. Область персонализации используется в различных областях персонализации для указания того, какой набор данных следует извлечь и отобразить.Personalization scope is used in various areas of personalization to indicate which set of data should be retrieved and displayed.

Если страница выполняется в Shared области персонализации, это означает, что должны быть загружены только данные персонализации для определенного элемента управления, применимые ко всем пользователям, просматривающим элемент управления.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. В зависимости от прав, выполняемых в настоящее время, эти широко применимые данные также можно изменить и сохранить обратно в хранилище данных.Depending on the currently executing user's rights, this broadly applicable data can also be modified and saved back to the data store. Если страница выполняется в User области персонализации, это означает, что данные персонализации элемента управления должны быть сохранены и загружены в соответствии с текущим выполняемым пользователем.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. Обычно это означает, что пользовательские данные могут быть загружены и сохранены в элементе управления, а широко используемые данные (или общие данные) можно просматривать только в элементе управления.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.

WebPartManagerЭлемент управления, который управляет высоким жизненным циклом персонализации, выполняется в одной из двух областей персонализации.A WebPartManager control, which manages the high-level life cycle of personalization, executes in one of the two personalization scopes.

Применяется к