WebPartPersonalization.ToggleScope Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
public:
virtual void ToggleScope();public virtual void ToggleScope();abstract member ToggleScope : unit -> unit
override this.ToggleScope : unit -> unitPublic Overridable Sub ToggleScope ()Uitzonderingen
De huidige gebruiker beschikt niet over de gebruikersmogelijkheid om een bereik in te voeren Shared bij een poging om over te schakelen van User bereik naar Shared bereik.
– of –
De initialisatie van het WebPartPersonalization exemplaar is niet voltooid.
– of –
Het Page exemplaar voor de gekoppelde WebPartManager is null.
– of –
De waarde van de Request eigenschap op het WebPartManager bijbehorende besturingselementexemplaar Page is null.
Er is een poging gedaan om een bereik in te schakelen dat niet is gedefinieerd in de PersonalizationScope opsomming. Technisch gezien mag deze situatie nooit optreden.
Voorbeelden
De volgende code demonstreert het gebruik van de ToggleScope methode. Deze code maakt deel uit van een groter codevoorbeeld in de WebPartPersonalization klassebeschrijving.
// 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
Opmerkingen
Met deze methode wordt het persoonlijke bereik van de pagina in-/uitschakelen. Als u het bereik wilt in- of uitschakelen, wordt teruggezet Transfer naar de huidige uitvoerpagina.
Deze methode voert geen bewerking uit als deze wordt aangeroepen tijdens het exporteren of importeren van een besturingselement voor webonderdelen.
Als een bereikaanvraag in-/uitschakelen plaatsvindt voor een pagina die is verzonden via een POST aanvraag, blijven alle queryreekswaarden behouden tijdens de overdracht. Queryreeksparameters blijven niet behouden als de pagina via een GET aanvraag is verzonden.