WebPartPersonalization.ToggleScope Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
public:
virtual void ToggleScope();public virtual void ToggleScope();abstract member ToggleScope : unit -> unit
override this.ToggleScope : unit -> unitPublic Overridable Sub ToggleScope ()Excepciones
El usuario actual no tiene la capacidad del usuario de especificar Shared el ámbito al intentar cambiar de User ámbito a Shared ámbito.
O bien
La instancia no ha completado la WebPartPersonalization inicialización.
O bien
La Page instancia del asociado WebPartManager es null.
O bien
El valor de la Request propiedad en la WebPartManager instancia asociada Page del control es null.
Se intentó alternar en un ámbito que no está definido en la PersonalizationScope enumeración. Técnicamente, esta situación nunca debería 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. Alternar el ámbito da como resultado una Transfer devolución a la página en ejecución actual.
Este método no realiza ninguna operación si se llama mientras se produce 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 conservarán si la página se envió a través de una GET solicitud.
