WebPartPersonalization.ToggleScope Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
public:
virtual void ToggleScope();public virtual void ToggleScope();abstract member ToggleScope : unit -> unit
override this.ToggleScope : unit -> unitPublic Overridable Sub ToggleScope ()Exceções
O usuário atual não tem a capacidade do usuário de inserir Shared escopo ao tentar mudar de User escopo para Shared escopo.
- ou -
A WebPartPersonalization instância não concluiu a inicialização.
- ou -
A Page instância do associado WebPartManager é null.
- ou -
O valor da Request propriedade na WebPartManager instância associada Page do controle é null.
Foi feita uma tentativa de alternar para um escopo que não está definido na PersonalizationScope enumeração. Tecnicamente, essa situação nunca deve ocorrer.
Exemplos
O código a seguir demonstra o uso do 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 página de 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, 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.
