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