PersonalizationProvider Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Implementa la funzionalità di base per un provider di personalizzazioni.
public ref class PersonalizationProvider abstract : System::Configuration::Provider::ProviderBasepublic abstract class PersonalizationProvider : System.Configuration.Provider.ProviderBasetype PersonalizationProvider = class
inherit ProviderBasePublic MustInherit Class PersonalizationProvider
Inherits ProviderBase- Ereditarietà
- 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:
GetCountOfState(PersonalizationScope, PersonalizationStateQuery) - Questo metodo deve essere in grado di contare il numero di righe di dati di personalizzazione nel database per i parametri di query forniti.
LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[]) - Dato il percorso e il nome utente, questo metodo carica due oggetti di grandi dimensioni binari dal database: un BLOB per i dati condivisi e uno per i dati utente. Se si specifica il nome utente e il percorso, non è necessario il WebPartManager controllo per accedere alle informazioni sulla pagina che possono fornire le informazioni sul nome utente/percorso.
ResetPersonalizationBlob(WebPartManager, String, String) - Dato il percorso e il nome utente, questo metodo elimina la riga corrispondente nel database. Se si specifica il nome utente e il percorso, non è necessario il WebPartManager controllo per accedere alle informazioni sulla pagina che possono fornire le informazioni sul nome utente/percorso.
SavePersonalizationBlob(WebPartManager, String, String, Byte[]) - Dato il percorso e il nome utente, questo metodo salva il BLOB fornito nel database. Se si specifica il nome utente e il percorso, non è necessario il WebPartManager controllo per accedere alle informazioni sulla pagina che possono fornire le informazioni sul nome utente/percorso.
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) |
