PersonalizationScope Enumeração

Definição

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

Indica o âmbito de personalização para um WebPartManager objeto ou o âmbito de personalização que se aplica a uma propriedade num controlo Web Parts.

public enum class PersonalizationScope
public enum PersonalizationScope
type PersonalizationScope = 
Public Enum PersonalizationScope
Herança
Object
ValueType
Enum
PersonalizationScope

Campos

Name Valor Description
User 0

Ao referir-se ao âmbito do WebPartManager controlo, User âmbito significa que os dados de personalização específicos do utilizador, bem como os dados de personalização que se aplicam a todos os utilizadores, são carregados para todos os controlos personalizáveis numa página. Apenas os dados de personalização específicos do utilizador podem ser guardados na página.
Ao referir-se ao âmbito associado a uma propriedade de controlo de Web Parts, User o âmbito indica que a propriedade só pode carregar e armazenar dados aplicáveis a todos os utilizadores quando está a correr numa página dentro Shared do âmbito. No entanto, quando o controlo da propriedade está a correr numa página dentro do User âmbito, os dados por utilizador e todos os utilizadores da propriedade serão carregados e fundidos. Neste caso, porém, apenas os dados por utilizador serão guardados quando uma página estiver a correr dentro User do âmbito de escopo.
Shared 1

Ao referir-se ao âmbito do WebPartManager controlo, Shared o âmbito significa que os dados de personalização aplicam-se a todos os utilizadores para todos os controlos personalizáveis numa página e também estão disponíveis para serem guardados na página.
Ao referir-se ao âmbito associado a uma propriedade de controlo de Web Parts, o Shared âmbito indica que a propriedade normalmente só permite carregar ou guardar dados associados a todos os utilizadores.

Exemplos

O exemplo seguinte demonstra o uso da PersonalizationScope enumeração:

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

Observações

O âmbito de personalização é um conceito chave na personalização de Web Parts e está fortemente integrado com outras configurações, incluindo o âmbito em que a página, através do WebPartManager controlo, está a correr; o âmbito associado a cada propriedade num controlo; e a forma como o controlo foi adicionado à página. Para mais informações sobre o âmbito da personalização, consulte Web Parts Personalization Overview.

O âmbito da personalização refere-se à forma como os dados de personalização são aplicáveis a diferentes conjuntos de utilizadores. Alguns dados de personalização são aplicáveis apenas a um utilizador específico e controlo numa página. Outros dados de personalização são aplicáveis a todos os utilizadores que visitam um site. O âmbito de personalização é utilizado em várias áreas de personalização para indicar que conjunto de dados deve ser recuperado e exibido.

Quando uma página está a correr dentro Shared do âmbito de personalização, isto indica que apenas os dados de personalização para um controlo específico, aplicáveis a todos os utilizadores que visualizam o controlo, devem ser carregados. Dependendo dos direitos do utilizador atualmente em execução, estes dados amplamente aplicados também podem ser modificados e guardados de volta no armazenamento de dados. Quando uma página está a correr em User âmbito de personalização, isto indica que os dados de personalização de um controlo devem ser guardados e carregados com base no utilizador que está a executar. Normalmente, isto significa que dados específicos do utilizador podem ser carregados e guardados num controlo, enquanto dados amplamente aplicáveis (ou dados partilhados) só podem ser visualizados no controlo.

Um WebPartManager controlo, que gere o ciclo de vida de alto nível da personalização, executa-se num dos dois escopos de personalização.

Aplica-se a