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

Определение

Указывает область персонализации для объекта WebPartManager или область персонализации, применяемую к свойству элемента управления веб-частей.

public enum class PersonalizationScope
public enum PersonalizationScope
type PersonalizationScope = 
Public Enum PersonalizationScope
Наследование
PersonalizationScope

Поля

Shared 1

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

User 0

Когда речь идет об области для элемента управления WebPartManager, область User означает, что для всех элементов управления на странице, поддерживающих персонализацию, загружаются данные персонализации для отдельных пользователей, а также данные персонализации, применяемые ко всем пользователям. На странице могут сохраняться только данные персонализации, относящиеся к отдельным пользователям.
Ссылаясь на область, связанную со свойством элемента управления веб-частей, область User указывает, что свойство обычно разрешает только загрузку и сохранение данных, связанных со всеми пользователями, при выполнении на странице в области Shared. Однако, когда элемент управления свойства выполняется на странице в User области, данные свойства для каждого пользователя и всех пользователей будут загружаться и объединяться. В этом случае, однако, при выполнении страницы в User области действия будут сохраняться только данные для каждого пользователя.

Примеры

В следующем примере показано использование перечисления PersonalizationScope :

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

Комментарии

Область персонализации является ключевым понятием персонализации веб-частей и тесно интегрирована с другими параметрами, включая область, в которой выполняется страница через WebPartManager элемент управления, область, связанная с каждым свойством элемента управления, и способ добавления элемента управления на страницу. Дополнительные сведения об области персонализации см. в статье Общие сведения о персонализации веб-частей.

Область персонализации относится к способу применения данных персонализации к разным наборам пользователей. Некоторые данные персонализации применимы только к определенному пользователю и элементу управления на странице. Другие данные персонализации применимы ко всем пользователям, просматривающим сайт. Область персонализации используется в различных областях персонализации, чтобы указать, какой набор данных следует извлечь и отобразить.

Когда страница выполняется в Shared области персонализации, это означает, что должны быть загружены только данные персонализации для определенного элемента управления, применимые ко всем пользователям, просматривающим элемент управления. В зависимости от прав пользователя, выполняющего в настоящее время, эти широко применимые данные также могут быть изменены и сохранены обратно в хранилище данных. Когда страница выполняется в User области персонализации, это означает, что данные персонализации элемента управления должны быть сохранены и загружены в зависимости от текущего выполняющегося пользователя. Как правило, это означает, что пользовательские данные можно загружать и сохранять в элементе управления, в то время как широко применимые данные (или общие данные) можно просматривать только в элементе управления.

Элемент WebPartManager управления, который управляет жизненным циклом персонализации высокого уровня, выполняется в одной из двух областей персонализации.

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