Поделиться через


WebPartPersonalization.ToggleScope Метод

Определение

Переключает область персонализации текущей страницы с области User на область Shared или с области Shared на область User.

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 запрос.

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

См. также раздел