PersonalizationScope Enumerazione

Definizione

Spazio dei nomi:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Indica l'ambito di personalizzazione di un oggetto WebPartManager oppure l'ambito di personalizzazione applicabile a una proprietà su un controllo Web part.

public enum class PersonalizationScope

public enum PersonalizationScope

type PersonalizationScope = 

Public Enum PersonalizationScope

Ereditarietà

Object

ValueType

Enum

PersonalizationScope

Campi

Shared	1	Quando si fa riferimento all'ambito nel controllo WebPartManager, l'ambito Shared indica che i dati di personalizzazione sono applicabili a tutti gli utenti per tutti i controlli personalizzabili in una pagina e che possono anche essere salvati nella pagina. Quando si fa riferimento all'ambito associato a una proprietà di controllo web part, l'ambito Shared indica che la proprietà in genere consente solo il caricamento o salvataggio dei dati associati a tutti gli utenti.
User	0	Quando si fa riferimento all'ambito nel controllo WebPartManager, l'ambito User indica che i dati di personalizzazione specifici di un utente, nonché i dati di personalizzazione applicabili a tutti gli utenti, vengono caricati per tutti i controlli personalizzabili in una pagina. Solo i dati di personalizzazione specifici di un utente possono essere salvati sulla pagina. Quando si fa riferimento all'ambito associato a una proprietà di controllo web part, l'ambito User indica che la proprietà può solo caricare e archiviare 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 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.

Esempio

Nell'esempio seguente viene illustrato l'uso 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 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à in un controllo e il modo in cui è stato aggiunto il controllo alla pagina. Per altre informazioni sull'ambito di personalizzazione, vedere Panoramica sulla 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 ampiamente applicabili possono essere modificati e salvati nuovamente nell'archivio dati. Quando una pagina è in esecuzione nell'ambito User della personalizzazione, indica che i dati di personalizzazione di un controllo devono essere salvati e caricati in base all'utente attualmente in esecuzione. In genere, questo significa che i dati specifici dell'utente possono essere caricati e salvati in un controllo, mentre i dati ampiamente applicabili (o i dati condivisi) possono essere visualizzati solo sul controllo.

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