WebPartPersonalization.ToggleScope Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
public:
virtual void ToggleScope();
public virtual void ToggleScope ();
abstract member ToggleScope : unit -> unit
override this.ToggleScope : unit -> unit
Public Overridable Sub ToggleScope ()
Исключения
Текущий пользователь не имеет пользовательской возможности входа в область Shared при попытке переключения с области User на область Shared.
-или-
Экземпляр WebPartPersonalization не завершил инициализацию.
-или-
Экземпляр Page для объекта WebPartManager равен null
.
-или-
Значение свойства Request для связанного экземпляра WebPartManager элемента управления the Page равно null
.
Произведена попытка переключения в область, которая не была определена в перечислении PersonalizationScope. С технической точки зрения подобная ситуация никогда не должна произойти.
Примеры
В следующем коде показано использование ToggleScope метода . Этот код является частью более крупного примера кода, найденного в описании WebPartPersonalization класса.
// Allows authorized user to change personalization scope.
protected void Toggle_Scope_Button_Click(object sender, EventArgs e)
{
if (_manager.Personalization.CanEnterSharedScope)
{
_manager.Personalization.ToggleScope();
}
}
' Allows authorized user to change personalization scope.
Protected Sub Toggle_Scope_Button_Click(ByVal sender As Object, ByVal e As EventArgs)
If _manager.Personalization.CanEnterSharedScope Then
_manager.Personalization.ToggleScope()
End If
End Sub 'Toggle_Scope_Button_Click
Комментарии
Этот метод переключает область персонализации текущей выполняемой страницы. Переключение области приводит к возврату к текущей Transfer странице выполнения.
Этот метод не выполняет никаких операций, если он вызывается во время экспорта или импорта элемента управления веб-частей.
Если запрос области переключения выполняется для страницы, отправленной POST
с помощью запроса, все значения строки запроса будут сохранены во время передачи; параметры строки запроса не сохраняются, если страница была отправлена через GET
запрос.