WebPartPersonalization.ToggleScope Méthode

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Bascule la portée de personnalisation de la page actuelle de User vers Shared, ou de Shared vers User.

public:
 virtual void ToggleScope();
public virtual void ToggleScope ();
abstract member ToggleScope : unit -> unit
override this.ToggleScope : unit -> unit
Public Overridable Sub ToggleScope ()

Exceptions

InvalidOperationException

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.

ArgumentOutOfRangeException

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 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.

S’applique à

Voir aussi