Udostępnij przez

WebPartPersonalization.ToggleScope Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls.WebParts
Zestaw:
System.Web.dll

Przełącza zakres personalizacji bieżącej strony z User do Shared lub z Shared do User.

public:
 virtual void ToggleScope();
public virtual void ToggleScope ();
abstract member ToggleScope : unit -> unit
override this.ToggleScope : unit -> unit
Public Overridable Sub ToggleScope ()

Wyjątki

InvalidOperationException

Bieżący użytkownik nie ma możliwości wprowadzania Shared zakresu podczas próby przełączenia z User zakresu na Shared zakres.

-lub-

Nie ukończono inicjowania WebPartPersonalization wystąpienia.

-lub-

Wystąpienie Page skojarzone WebPartManager nullto .

-lub-

Wartość Request właściwości skojarzonego WebPartManager Page wystąpienia kontrolki to null.

ArgumentOutOfRangeException

Podjęto próbę przełączenia do zakresu, który nie jest zdefiniowany w wyliczeniem PersonalizationScope . Technicznie ta sytuacja nigdy nie powinna wystąpić.

Przykłady

Poniższy kod demonstruje użycie ToggleScope metody . Ten kod jest częścią większego przykładu kodu znalezionego w opisie WebPartPersonalization klasy.

// 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

Uwagi

Ta metoda przełącza zakres personalizacji aktualnie wykonywanej strony. Przełączenie zakresu powoduje Transfer powrót do bieżącej strony wykonywania.

Ta metoda nie wykonuje żadnej operacji, jeśli jest wywoływana podczas eksportowania lub importowania kontrolki składniki Web Part.

Jeśli żądanie zakresu przełączania występuje dla strony przesłanej POST za pośrednictwem żądania, wszystkie wartości ciągu zapytania zostaną zachowane podczas transferu; parametry ciągu zapytania nie są zachowywane, jeśli strona została przesłana za pośrednictwem GET żądania.

Dotyczy

Zobacz też