PersonalizationScope Enumeração

Definição

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Indica o escopo de personalização para um objeto WebPartManager ou o escopo de personalização que se aplica a uma propriedade em um controle de Web Parts.

public enum class PersonalizationScope

public enum PersonalizationScope

type PersonalizationScope = 

Public Enum PersonalizationScope

Herança

Object

ValueType

Enum

PersonalizationScope

Campos

Shared	1	Ao fazer referência ao escopo no controle WebPartManager, o escopo Shared significa que os dados de personalização se aplicam a todos os usuários para todos os controles personalizáveis em uma página e também estão disponíveis para serem salvos na página. Ao fazer referência ao escopo associado com uma propriedade de controle Web Parts, o escopo Shared indica que a propriedade normalmente só permite carregar ou salvar dados associados a todos os usuários.
User	0	Ao fazer referência ao escopo no controle WebPartManager, o escopo User significa que os dados de personalização específicos do usuário, bem como os dados de personalização que se aplicam a todos os usuários, são carregados para todos os controles personalizáveis em uma página. Somente os dados de personalização específicos do usuário podem ser salvos na página. Ao fazer referência ao escopo associado a uma propriedade de controle Web Parts, o escopo User indica que a propriedade só pode carregar e armazenar dados aplicáveis a todos os usuários durante a execução em uma página no escopo Shared. No entanto, quando o controle da propriedade estiver em execução em uma página no User escopo, os dados por usuário e todos os usuários da propriedade serão carregados e mesclados. Nesse caso, porém, somente os dados por usuário serão salvos quando uma página estiver em execução no User escopo do escopo.

Exemplos

O exemplo a seguir demonstra como usar a PersonalizationScope enumeração :

if (_manager.Personalization.Scope == PersonalizationScope.Shared)
{
    TextBox2.Text = "Shared Scope";
}
else
    TextBox2.Text = "User Scope";

Comentários

O escopo de personalização é um conceito fundamental na personalização de Web Parts e é totalmente integrado a outras configurações, incluindo o escopo no qual a página, por meio do WebPartManager controle, está em execução; o escopo associado a cada propriedade em um controle e a maneira como o controle foi adicionado à página. Para obter mais informações sobre o escopo de personalização, consulte Visão geral de personalização de Web Parts.

O escopo de personalização refere-se a como os dados de personalização são aplicáveis a diferentes conjuntos de usuários. Alguns dados de personalização são aplicáveis apenas a um usuário específico e controle em uma página. Outros dados de personalização são aplicáveis a todos os usuários que exibem um site. O escopo de personalização é usado em várias áreas de personalização para indicar qual conjunto de dados deve ser recuperado e exibido.

Quando uma página está em execução no Shared escopo de personalização, isso indica que apenas os dados de personalização de um controle específico, aplicáveis a todos os usuários que exibem o controle, devem ser carregados. Dependendo dos direitos do usuário em execução no momento, esses dados amplamente aplicáveis também podem ser modificados e salvos de volta no armazenamento de dados. Quando uma página está em execução no User escopo de personalização, isso indica que os dados de personalização de um controle devem ser salvos e carregados com base no usuário em execução no momento. Normalmente, isso significa que dados específicos do usuário podem ser carregados e salvos em um controle, enquanto dados amplamente aplicáveis (ou dados compartilhados) só podem ser exibidos no controle.

Um WebPartManager controle, que gerencia o ciclo de vida de alto nível de personalização, é executado em um dos dois escopos de personalização.