WebPartPersonalization.ToggleScope Metod

Definition

Namnområde:
System.Web.UI.WebControls.WebParts
Sammansättning:
System.Web.dll

Växlar den aktuella sidans anpassningsomfång från User till Shared eller från Shared till User.

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

Undantag

InvalidOperationException

Den aktuella användaren har inte användarfunktionen för att ange Shared omfång när han eller hon försöker växla från User omfång till Shared omfång.

-eller-

Instansen WebPartPersonalization har inte slutfört initieringen.

-eller-

Instansen Page för den associerade WebPartManager är null.

-eller-

Värdet för Request egenskapen på kontrollens WebPartManager associerade Page instans är null.

ArgumentOutOfRangeException

Ett försök gjordes att växla till ett omfång som inte har definierats i PersonalizationScope uppräkningen. Tekniskt sett bör den här situationen aldrig inträffa.

Exempel

Följande kod visar hur du använder ToggleScope metoden. Den här koden är en del av ett större kodexempel som finns i WebPartPersonalization klassbeskrivningen.

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

Kommentarer

Den här metoden växlar omfånget för den aktuella körningssidans anpassning. Om du växlar omfånget återgår Transfer du till den aktuella körningssidan.

Den här metoden utför ingen åtgärd om den anropas när en export eller import av en webbdelskontroll sker.

Om en begäran om växlingsomfång inträffar för en sida som skickades via en POST begäran bevaras alla frågesträngsvärden under överföringen. Frågesträngsparametrar bevaras inte om sidan skickades via en GET begäran.

Gäller för

Se även