Udostępnij za pośrednictwem

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 się z User zakresu na Shared zakres.

-lub-

Nie ukończono inicjowania WebPartPersonalization wystąpienia.

-lub-

Wystąpienie Page skojarzone WebPartManagernullto .

-lub-

Wartość Request właściwości skojarzonego WebPartManagerPage 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 pokazuje 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 włącza aktualnie wykonywany zakres personalizacji 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ładników Web Part.

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

Dotyczy

Zobacz też