Share via

WebPartPersonalization.ToggleScope Método

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls.WebParts
Ensamblado:
System.Web.dll

Cambia el ámbito de personalización de la página actual de User a Shared o de Shared a User.

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

Excepciones

InvalidOperationException

El usuario actual no tiene la función del usuario para entrar en el ámbito Shared cuando se intenta cambiar del ámbito User al ámbito Shared.

o bien

La instancia de WebPartPersonalization no ha completado la inicialización.

o bien

La instancia de Page para el objeto WebPartManager asociado es null.

o bien

El valor de la propiedad Request en la instancia WebPartManager asociada del control Page es null.

ArgumentOutOfRangeException

Se intentó cambiar a un ámbito no definido en la enumeración PersonalizationScope. Técnicamente, esta situación nunca debe producirse.

Ejemplos

En el código siguiente se muestra el uso del ToggleScope método . Este código forma parte de un ejemplo de código más grande que se encuentra en la descripción de la WebPartPersonalization clase.

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

Comentarios

Este método alterna el ámbito de personalización de la página que se está ejecutando actualmente. Al alternar el ámbito, se devuelve a Transfer la página en ejecución actual.

Este método no realiza ninguna operación si se llama mientras se está produciendo una exportación o importación de un control de elementos web.

Si se produce una solicitud de ámbito de alternancia para una página enviada a través de una POST solicitud, los valores de cadena de consulta se conservarán durante la transferencia; los parámetros de cadena de consulta no se conservan si la página se envió a través de una GET solicitud.

Se aplica a

Consulte también