WebPartPersonalization.ToggleScope Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
public:
virtual void ToggleScope();public virtual void ToggleScope ();abstract member ToggleScope : unit -> unit
override this.ToggleScope : unit -> unitPublic Overridable Sub ToggleScope ()Ausnahmen
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.
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 aktuell ausgeführten Seite um. Das Umschalten des Bereichs führt zu einem Transfer Zurück zur aktuell ausgeführten Seite.
Diese Methode führt keinen Vorgang aus, wenn sie aufgerufen wird, während ein Export oder Import eines Webparts-Steuerelements erfolgt.
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.
