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