PersonalizationProvider Classe

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Implementa la funzionalità di base per un provider di personalizzazioni.

public ref class PersonalizationProvider abstract : System::Configuration::Provider::ProviderBase
public abstract class PersonalizationProvider : System.Configuration.Provider.ProviderBase
type PersonalizationProvider = class
    inherit ProviderBase
Public MustInherit Class PersonalizationProvider
Inherits ProviderBase
Ereditarietà
Object
ProviderBase
PersonalizationProvider
Derivato

Commenti

Si tratta della classe base astratta che definisce la funzionalità necessaria di un provider di personalizzazione. Un provider di personalizzazione carica e archivia i dati di personalizzazione per conto di un'istanza WebPartPersonalization .

La classe base definisce il comportamento standard per un numero di metodi; solo i metodi che gestiscono in modo specifico l'archivio dati sottostante sono contrassegnati come astratti. In questo modo uno sviluppatore può scrivere un provider personalizzato per interagire con un archivio dati specifico, senza dover implementare nuovamente le funzionalità standard usate dalla WebPartPersonalization classe.

Note per gli implementatori

È possibile derivare da PersonalizationProvider e fornire implementazioni solo per i metodi astratti definiti in questa classe. I metodi astratti gestiscono in modo specifico il salvataggio e il caricamento dei dati in un archivio dati fisico e con l'amministrazione dell'archivio dati. Un provider personalizzato deve essere in grado di modificare le informazioni di personalizzazione in modo da distinguere Shared i dati dai User dati. Inoltre, un provider deve segmentare i dati di personalizzazione in base alla pagina e all'applicazione.

Le implementazioni di PersonalizationProvider sono strettamente associate alle implementazioni di PersonalizationState perché alcuni metodi del provider di personalizzazione restituiscono istanze di PersonalizationStateclassi derivate. Per semplificare lo sviluppo di provider personalizzati, la PersonalizationProvider classe base include un'implementazione predefinita della logica di personalizzazione e della logica di serializzazione/deserializzazione usata direttamente dalla WebPartPersonalization classe. Di conseguenza, la creazione di un provider personalizzato esclusivamente allo scopo di usare un archivio dati diverso richiede solo l'implementazione dei metodi astratti seguenti:

In tutti questi metodi, se viene fornito solo un percorso, che indica che i dati di personalizzazione condivisi per la pagina vengono gestiti. Se sia un percorso che un nome utente vengono passati a un metodo, i dati di personalizzazione dell'utente per la pagina devono essere eseguiti. Nel caso di LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[]), i dati condivisi per il percorso specificato devono essere sempre caricati e, facoltativamente, i dati di personalizzazione utente per il percorso devono essere caricati anche se il nome utente non nullè .

Tutti gli altri metodi astratti sono destinati all'uso solo nelle applicazioni amministrative e non vengono usati dall'infrastruttura web part in fase di esecuzione. Per un esempio di implementazione di un provider di personalizzazione, vedere la SqlPersonalizationProvider classe .

Costruttori

PersonalizationProvider()

Inizializza una nuova istanza della classe PersonalizationProvider.

Proprietà

ApplicationName

Quando si esegue l'override in una classe derivata, ottiene o imposta il nome dell'applicazione configurata per il provider.
Description

Ottiene una breve descrizione di facile comprensione che è possibile visualizzare in strumenti di amministrazione o in altre interfacce utente (UI, User Interface).

(Ereditato da ProviderBase)
Name

Ottiene il nome descrittivo utilizzato per fare riferimento al provider durante la configurazione.

(Ereditato da ProviderBase)

Metodi

CreateSupportedUserCapabilities()

Restituisce un elenco di oggetti WebPartUserCapability che rappresentano l'insieme di funzionalità note utilizzate dal set dei controlli Web part.
DetermineInitialScope(WebPartManager, PersonalizationState)

Determina se l'ambito iniziale di personalizzazione deve essere Shared o User.
DetermineUserCapabilities(WebPartManager)

Restituisce un dizionario contenente istanze WebPartUserCapability che rappresentano le funzionalità correlate alla personalizzazione dell'account utente attualmente in esecuzione.
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
FindState(PersonalizationScope, PersonalizationStateQuery, Int32, Int32, Int32)

Quando viene sottoposto a override in una classe derivata, restituisce un insieme che contiene zero o più oggetti derivati da PersonalizationStateInfo in base all'ambito e a parametri di query specifici.
GetCountOfState(PersonalizationScope, PersonalizationStateQuery)

Quando viene sottoposto a override in una classe derivata, restituisce il numero di righe dell'archivio dati sottostante esistenti nell'ambito specificato.
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
Initialize(String, NameValueCollection)

Inizializza il generatore di configurazione.

(Ereditato da ProviderBase)
LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[])

Quando viene sottoposto a override in una classe derivata, carica dati sulla personalizzazione non elaborati dall'archivio dati sottostante.
LoadPersonalizationState(WebPartManager, Boolean)

Carica i dati non elaborati dall'archivio dati sottostante e li converte in un oggetto PersonalizationState.
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
ResetPersonalizationBlob(WebPartManager, String, String)

Quando viene sottoposto a override in una classe derivata, elimina dati sulla personalizzazione non elaborati dall'archivio dati sottostante.
ResetPersonalizationState(WebPartManager)

Reimposta i dati sulla personalizzazione nell'archivio dati sottostante.
ResetState(PersonalizationScope, String[], String[])

Quando viene sottoposto a override in una classe derivata, elimina lo stato di personalizzazione dell'archivio dati sottostante sulla base dei parametri specificati.
ResetUserState(String, DateTime)

Quando viene sottoposto a override in una classe derivata, elimina i dati sulla personalizzazione di Web part dall'archivio dati sottostante sulla base dei parametri specificati.
SavePersonalizationBlob(WebPartManager, String, String, Byte[])

Quando viene sottoposto a override in una classe derivata, salva i dati sulla personalizzazione non elaborati nell'archivio dati sottostante.
SavePersonalizationState(PersonalizationState)

Salva i dati sulla personalizzazione in un archivio dati.
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Si applica a

Vedi anche