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
Der aktuelle Benutzer verfügt nicht über die Möglichkeit, den Bereich einzugeben Shared , wenn versucht wird, von User Bereich zu Bereich zu Shared wechseln.
-oder-
Die Instanz hat die WebPartPersonalization Initialisierung nicht abgeschlossen.
-oder-
Die Page Instanz für die zugeordnete WebPartManager Datei ist null.
-oder-
Der Wert der Request Eigenschaft für die WebPartManager zugeordnete Page Instanz des Steuerelements lautet null.
Es wurde versucht, auf einen Bereich umzuschalten, der in der PersonalizationScope Enumeration nicht definiert ist. Technisch sollte diese Situation niemals 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
Mit dieser Methode wird der Personalisierungsbereich der aktuell ausgeführten Seite umgeschaltet. Das Umschalten des Bereichs führt zu einer Transfer Zurück-zu der aktuellen Ausführungsseite.
Diese Methode führt keinen Vorgang aus, wenn sie aufgerufen wird, während ein Export- oder Import eines Webpart-Steuerelements auftritt.
Wenn eine Umschalterbereichsanforderung für eine Seite auftritt, die über eine POST Anforderung übermittelt wurde, werden während der Übertragung alle Abfragezeichenfolgenwerte beibehalten. Abfragezeichenfolgenparameter werden nicht beibehalten, wenn die Seite über eine GET Anforderung übermittelt wurde.
