WebPartPersonalization.ToggleScope Methode

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Schaltet den Personalisierungsbereich der aktuellen Seite von User auf Shared oder von Shared auf User um.

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

Ausnahmen

InvalidOperationException

Beim Versuch, vom Shared-Bereich auf den User-Bereich umzuschalten, besitzt der aktuelle Benutzer nicht die erforderliche Berechtigung für den Zugriff auf den Shared-Bereich.

- oder -

Die WebPartPersonalization-Instanz hat die Initialisierung nicht abgeschlossen.

- oder -

Die Page-Instanz für den zugeordneten WebPartManager ist null.

- oder -

Der Wert der Request-Eigenschaft für die dem WebPartManager-Steuerelement zugeordnete Page-Instanz ist null.

ArgumentOutOfRangeException

Es wurde der Versuch unternommen, auf einen Bereich umzuschalten, der nicht in der PersonalizationScope-Enumeration definiert ist. Technisch betrachtet, dürfte diese Situation eigentlich nie auftreten.

Beispiele

Der folgende Code veranschaulicht die Verwendung der ToggleScope -Methode. Dieser Code ist Teil eines größeren Codebeispiels in der WebPartPersonalization Klassenbeschreibung.

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

Hinweise

Diese Methode schaltet den Personalisierungsbereich der gerade ausgeführten Seite um. Das Umschalten des Bereichs führt zu einer Transfer Rückkehr zur aktuell ausgeführten Seite.

Diese Methode führt keinen Vorgang aus, wenn sie aufgerufen wird, während ein Export oder Import eines Webpart-Steuerelements stattfindet.

Wenn eine Umschalterbereichsanforderung für eine Seite auftritt, die über eine POST Anforderung übermittelt wurde, werden alle Abfragezeichenfolgenwerte während der Übertragung beibehalten. Abfragezeichenfolgenparameter werden nicht beibehalten, wenn die Seite über eine GET Anforderung übermittelt wurde.

Gilt für:

Weitere Informationen