WebPartPersonalization.ToggleScope Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
public:
virtual void ToggleScope();public virtual void ToggleScope ();abstract member ToggleScope : unit -> unit
override this.ToggleScope : unit -> unitPublic Overridable Sub ToggleScope ()Exceptions
L'utilisateur en cours ne dispose pas de la fonctionnalité utilisateur qui permet d'entrer une portée Shared lors de la tentative de basculement d'une portée User vers une portée Shared.
- ou -
L'instance de WebPartPersonalization n'a pas terminé initialisation.
- ou -
L'instance de Page du WebPartManager associé est null.
- ou -
La valeur de la propriété Request de l'instance de WebPartManager associée du contrôle Page est null.
Une tentative de basculement vers une portée non définie dans l'énumération PersonalizationScope a eu lieu. Techniquement, cette situation ne doit jamais se produire.
Exemples
Le code suivant illustre l’utilisation de la ToggleScope méthode . Ce code fait partie d’un plus grand exemple de code trouvé dans la description de la WebPartPersonalization classe.
// 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
Remarques
Cette méthode bascule l’étendue de personnalisation de la page en cours d’exécution. Le basculement de l’étendue entraîne un Transfer retour à la page en cours d’exécution.
Cette méthode n’effectue aucune opération si elle est appelée lors de l’exportation ou de l’importation d’un contrôle WebPart.
Si une demande d’étendue bascule se produit pour une page qui a été envoyée via une POST demande, les valeurs de chaîne de requête sont conservées pendant le transfert ; les paramètres de chaîne de requête ne sont pas conservés si la page a été envoyée via une GET requête.
