WebPartPersonalization.ToggleScope Método

Definição

Espaço de Nomes:
System.Web.UI.WebControls.WebParts
Assemblagem:
System.Web.dll

Altera o âmbito de personalização da página atual de User para Shared ou de Shared para User.

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

Exceções

InvalidOperationException

O utilizador atual não tem capacidade para introduzir Shared o âmbito ao tentar mudar de User âmbito para Shared scope.

-ou-

A WebPartPersonalization instância ainda não completou a inicialização.

-ou-

A Page instância para o associado WebPartManager é null.

-ou-

O valor da Request propriedade na WebPartManager instância associada Page ao controlo é null.

ArgumentOutOfRangeException

Foi feita uma tentativa de alternar para um âmbito que não está definido na PersonalizationScope enumeração. Tecnicamente, esta situação nunca deveria acontecer.

Exemplos

O código seguinte demonstra o uso do ToggleScope método. Este código faz parte de um exemplo de código maior encontrado na descrição da 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

Observações

Este método alterna o âmbito de personalização da página em execução. Alternar o escopo resulta num Transfer regresso à página em execução atual.

Este método não executa qualquer operação se for chamado enquanto estiver a ocorrer uma exportação ou importação de um controlo de Web Parts.

Se ocorrer um pedido de âmbito de alternância para uma página submetida através de um POST pedido, quaisquer valores de cadeia de consulta serão preservados durante a transferência; os parâmetros da cadeia de consulta não são preservados se a página foi submetida através de um GET pedido.

Aplica-se a

Ver também