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 actuel n’a pas la possibilité d’entrer l’étendue Shared lors de la tentative de passage de User l’étendue à Shared l’étendue.
- ou -
L’instance WebPartPersonalization n’a pas terminé l’initialisation.
- ou -
L’instance Page de l’associé WebPartManager est null.
- ou -
La valeur de la propriété sur l’instance RequestWebPartManager associée Page du contrôle est null.
Une tentative a été effectuée pour basculer vers une étendue qui n’est pas définie dans l’énumération PersonalizationScope . Techniquement, cette situation ne devrait jamais se produire.
Exemples
Le code suivant illustre l’utilisation de la ToggleScope méthode. Ce code fait partie d’un exemple de code plus volumineux 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 envoyée via une POST demande, toutes 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 demande.
