PersonalizationScope Enumerazione

Definizione

Indica l'ambito di personalizzazione per un oggetto WebPartManager o l'ambito di personalizzazione applicabile a una proprietà in un controllo Web part.

public enum class PersonalizationScope
public enum PersonalizationScope
type PersonalizationScope = 
Public Enum PersonalizationScope
Ereditarietà
PersonalizationScope

Campi

Nome Valore Descrizione
User 0

Quando si fa riferimento all'ambito nel WebPartManager controllo, User l'ambito indica che i dati di personalizzazione specifici dell'utente, nonché i dati di personalizzazione che si applicano a tutti gli utenti, vengono caricati per tutti i controlli personalizzabili in una pagina. Solo i dati di personalizzazione specifici dell'utente possono essere salvati nella pagina.
Quando si fa riferimento all'ambito associato a una proprietà di controllo web part, User l'ambito indica che la proprietà può caricare e archiviare solo i dati applicabili a tutti gli utenti durante l'esecuzione in una pagina nell'ambito Shared . Tuttavia, quando il controllo della proprietà è in esecuzione in una pagina nell'ambito User , i dati per utente e tutti gli utenti della proprietà verranno caricati e uniti. In questo caso, tuttavia, solo i dati per utente verranno salvati quando una pagina è in esecuzione nell'ambito User dell'ambito.

Shared 1

Quando si fa riferimento all'ambito nel WebPartManager controllo, Shared l'ambito indica che i dati di personalizzazione si applicano a tutti gli utenti per tutti i controlli personalizzabili in una pagina ed è disponibile anche per essere salvati nella pagina.
Quando si fa riferimento all'ambito associato a una proprietà del controllo Web part, Shared l'ambito indica che la proprietà normalmente consente solo il caricamento o il salvataggio dei dati associati a tutti gli utenti.

Esempio

Nell'esempio seguente viene illustrato l'utilizzo dell'enumerazione PersonalizationScope :

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

Commenti

L'ambito di personalizzazione è un concetto chiave nella personalizzazione delle web part ed è strettamente integrato con altre impostazioni, incluso l'ambito in cui la pagina, tramite il WebPartManager controllo, è in esecuzione, l'ambito associato a ogni proprietà di un controllo e il modo in cui il controllo è stato aggiunto alla pagina. Per altre informazioni sull'ambito di personalizzazione, vedere Panoramica della personalizzazione delle web part.

L'ambito di personalizzazione si riferisce al modo in cui i dati di personalizzazione sono applicabili a diversi set di utenti. Alcuni dati di personalizzazione sono applicabili solo a un utente e a un controllo specifici in una pagina. Altri dati di personalizzazione sono applicabili a tutti gli utenti che visualizzano un sito. L'ambito di personalizzazione viene usato in varie aree di personalizzazione per indicare quale set di dati deve essere recuperato e visualizzato.

Quando una pagina è in esecuzione nell'ambito Shared della personalizzazione, questo indica che devono essere caricati solo i dati di personalizzazione per un controllo specifico, applicabile a tutti gli utenti che visualizzano il controllo. A seconda dei diritti dell'utente attualmente in esecuzione, questi dati applicabili a livello generale possono essere modificati e salvati nuovamente nell'archivio dati. Quando una pagina è in esecuzione nell'ambito User della personalizzazione, questo indica che i dati di personalizzazione di un controllo devono essere salvati e caricati in base all'utente attualmente in esecuzione. In genere, ciò significa che i dati specifici dell'utente possono essere caricati e salvati in un controllo, mentre i dati applicabili su larga scala (o i dati condivisi) possono essere visualizzati solo nel controllo.

Un WebPartManager controllo, che gestisce il ciclo di vita generale della personalizzazione, viene eseguito in uno dei due ambiti di personalizzazione.

Si applica a