WebPartPersonalization.ToggleScope Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
public:
virtual void ToggleScope();public virtual void ToggleScope ();abstract member ToggleScope : unit -> unit
override this.ToggleScope : unit -> unitPublic Overridable Sub ToggleScope ()Výjimky
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.
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í.
