WebPartPersonalization.ToggleScope Método

  • Referência

Definição

Namespace:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Muda o escopo 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 usuário atual não tem uma funcionalidade de usuário para inserir o escopo Shared ao tentar mudar do escopo User para o escopo Shared.

- ou -

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

- ou -

A instância Page do WebPartManager associado é null.

- ou -

O valor da propriedade Request na instância Page associada do controle WebPartManager é null.

ArgumentOutOfRangeException

Foi feita uma tentativa para alternar para um escopo não definido na enumeração PersonalizationScope. Tecnicamente, essa situação nunca deveria ocorrer.

Exemplos

O código a seguir demonstra como usar o ToggleScope método . Esse 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

Comentários

Esse método alterna o escopo de personalização da página em execução no momento. Alternar o escopo resulta em uma Transfer volta para a página em execução atual.

Esse método não executará nenhuma operação se for chamado enquanto uma exportação ou importação de um controle de Web Parts estiver ocorrendo.

Se ocorrer uma solicitação de escopo de alternância para uma página que foi enviada por meio de uma POST solicitação, todos os valores de cadeia de caracteres de consulta serão preservados durante a transferência; os parâmetros de cadeia de caracteres de consulta não serão preservados se a página tiver sido enviada por meio de uma GET solicitação.

Aplica-se a

Confira também