Sdílet prostřednictvím

WebPartPersonalization.ToggleScope Metoda

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls.WebParts
Sestavení:
System.Web.dll

Přepne obor přizpůsobení aktuální stránky z User na Shared nebo z Shared na User.

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

Výjimky

InvalidOperationException

Aktuální uživatel nemá možnost zadat Shared obor při pokusu o přepnutí z User oboru na Shared obor.

-nebo-

Instance WebPartPersonalization nedokončila inicializaci.

-nebo-

Přidružená PageWebPartManager instance je null.

-nebo-

Hodnota Request vlastnosti v instanci přidružené Page k WebPartManager ovládacího prvku je null.

ArgumentOutOfRangeException

Došlo k pokusu o přepnutí na obor, který není definován ve výčtu PersonalizationScope . Technicky vzato by tato situace nikdy neměla nastat.

Příklady

Následující kód ukazuje použití ToggleScope metody . Tento kód je součástí většího vzorku kódu, který se nachází v WebPartPersonalization popisu třídy.

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

Poznámky

Tato metoda přepíná rozsah přizpůsobení aktuálně spuštěné stránky. Přepnutím oboru Transfer se vrátíte zpět na aktuální spuštěnou stránku.

Tato metoda neprovádí žádnou operaci, pokud je volána při exportu nebo importu webové části ovládacího prvku probíhá.

Pokud dojde k požadavku na přepnutí oboru stránky, která byla odeslána prostřednictvím POST požadavku, všechny hodnoty řetězce dotazu se během přenosu zachovají. Pokud byla stránka odeslána prostřednictvím GET požadavku, parametry řetězce dotazu se nezachovají.

Platí pro

Viz také