PersonalizationProvider Classe

Definizione

Implementa la funzionalità di base per un provider di personalizzazioni.Implements the basic functionality for a personalization provider.

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à
PersonalizationProvider
Derivato

Commenti

Si tratta della classe di base astratta che definisce la funzionalità richiesta di un provider di personalizzazioni.This is the abstract base class that defines the required functionality of a personalization provider. Un provider di personalizzazioni carica e archivia i dati di personalizzazione per WebPartPersonalization conto di un'istanza.A personalization provider both loads and stores personalization data on behalf of a WebPartPersonalization instance.

La classe base definisce il comportamento standard per diversi metodi. solo i metodi che gestiscono in modo specifico l'archivio dati sottostante sono contrassegnati come abstract.The base class defines standard behavior for a number of methods; only those methods that specifically deal with the underlying data store are marked abstract. Ciò consente a uno sviluppatore di scrivere un provider personalizzato per interagire con un archivio dati specifico, senza dover implementare di nuovo la WebPartPersonalization funzionalità standard utilizzata dalla classe.This allows a developer to write a custom provider to interact with a specific data store, without needing to re-implement standard functionality used by the WebPartPersonalization class.

Note per gli implementatori

È possibile derivare PersonalizationProvider da e fornire implementazioni solo per i metodi astratti definiti in questa classe.You can derive from PersonalizationProvider and provide implementations for only the abstract methods defined in this class. 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.The abstract methods deal specifically with saving and loading data to a physical data store, and with data store administration. Un provider personalizzato deve essere in grado di modificare le informazioni sulla personalizzazione in modo da distinguere Shared i dati User dai dati.A custom provider must be capable of manipulating personalization information in a manner that distinguishes Shared data from User data. Inoltre, un provider deve segmentare i dati di personalizzazione per pagina e per applicazione.Furthermore, a provider must segment personalization data by page as well as by application.

Le implementazioni PersonalizationProvider di sono strettamente associate alle implementazioni di PersonalizationState perché alcuni metodi del provider di personalizzazione restituiscono PersonalizationStateistanze di classi derivate da.Implementations of PersonalizationProvider are tightly coupled to implementations of PersonalizationState because some personalization provider methods return instances of PersonalizationState-derived classes. Per semplificare lo sviluppo di provider personalizzati, PersonalizationProvider la classe base include un'implementazione predefinita della logica di personalizzazione e della logica di serializzazione/deserializzazione utilizzata direttamente WebPartPersonalization dalla classe.To ease development of custom providers, the PersonalizationProvider base class includes a default implementation of the personalization logic and serialization/deserialization logic that is used directly by the WebPartPersonalization class. Di conseguenza, la creazione di un provider personalizzato esclusivamente allo scopo di utilizzare un archivio dati diverso richiede solo l'implementazione dei seguenti metodi astratti:As a result, authoring a custom provider solely for the purpose of working with a different data store only requires implementation of the following abstract methods:

  • GetCountOfState(PersonalizationScope, PersonalizationStateQuery) - This method needs to be able to count the number of rows of personalization data in the database for the supplied query parameters.

  • LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[])-Dato il percorso e il nome utente, questo metodo carica due oggetti binari di grandi dimensioni (BLOB) dal database: un BLOB per i dati condivisi e uno per i dati utente.
  • LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[]) - Given the path and user name, this method loads two binary large objects (BLOBs) from the database: one BLOB for shared data and one for user data.
  • Se si specificano il nome utente e il percorso, non è necessario che WebPartManager il controllo acceda alle informazioni della pagina che possono fornire le informazioni relative al nome utente e al percorso.If you supply the user name and path, then you do not need the WebPartManager control to access the page information that can provide the user name/path information.
  • ResetPersonalizationBlob(WebPartManager, String, String)-Dato il percorso e il nome utente, questo metodo elimina la riga corrispondente nel database.
  • ResetPersonalizationBlob(WebPartManager, String, String) - Given the path and user name, this method deletes the corresponding row in the database.
  • Se si specificano il nome utente e il percorso, non è necessario che WebPartManager il controllo acceda alle informazioni della pagina che possono fornire le informazioni relative al nome utente e al percorso.If you supply the user name and path, then you do not need the WebPartManager control to access the page information that can provide the user name/path information.
  • SavePersonalizationBlob(WebPartManager, String, String, Byte[])-Dato il percorso e il nome utente, questo metodo salva il BLOB fornito nel database.
  • SavePersonalizationBlob(WebPartManager, String, String, Byte[]) - Given the path and user name, this method saves the supplied BLOB to the database.
  • Se si specificano il nome utente e il percorso, non è necessario che WebPartManager il controllo acceda alle informazioni della pagina che possono fornire le informazioni relative al nome utente e al percorso.If you supply the user name and path, then you do not need the WebPartManager control to access the page information that can provide the user name/path information.

    In tutti questi metodi, se viene fornito solo un percorso, che indica che i dati di personalizzazione condivisi per la pagina vengono gestiti.In all of these methods, if only a path is supplied, that indicates the shared personalization data for the page is being operated upon. Se un percorso e un nome utente vengono passati a un metodo, sarà necessario agire sui dati di personalizzazione dell'utente per la pagina.If both a path and a username are passed to a method, then the user personalization data for the page should be acted upon. Nel caso di LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[]), è necessario caricare sempre i dati condivisi per il percorso specificato e, facoltativamente, anche i dati sulla personalizzazione dell'utente per il percorso se il nome utente non nullè.In the case of LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[]), the shared data for the specified path should always be loaded, and optionally the user personalization data for the path should also be loaded if the username is not null.

    Tutti gli altri metodi astratti sono progettati per essere utilizzati solo nelle applicazioni amministrative e non vengono utilizzati dall'infrastruttura Web part in fase di esecuzione.All other abstract methods are intended for use only in administrative applications and are not used by the Web Parts infrastructure at run time. Per un esempio di implementazione di un provider di personalizzazioni, vedere SqlPersonalizationProvider la classe.For an example of an implementation of a personalization provider, see the SqlPersonalizationProvider class.

    Costruttori

    PersonalizationProvider()

    Inizializza una nuova istanza della classe PersonalizationProvider.Initializes a new instance of the PersonalizationProvider class.

    Proprietà

    ApplicationName

    Quando si esegue l'override in una classe derivata, ottiene o imposta il nome dell'applicazione configurata per il provider.When overridden in a derived class, gets or sets the name of the application configured for the provider.

    Description

    Ottiene una breve descrizione di facile comprensione che è possibile visualizzare in strumenti di amministrazione o in altre interfacce utente (UI, User Interface).Gets a brief, friendly description suitable for display in administrative tools or other user interfaces (UIs).

    (Ereditato da ProviderBase)
    Name

    Ottiene il nome descrittivo utilizzato per fare riferimento al provider durante la configurazione.Gets the friendly name used to refer to the provider during configuration.

    (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.Returns a list of WebPartUserCapability objects that represent the set of known capabilities used by the Web Parts control set.

    DetermineInitialScope(WebPartManager, PersonalizationState)

    Determina se l'ambito iniziale di personalizzazione deve essere Shared o User.Determines whether the initial personalization scope should be Shared or User scope.

    DetermineUserCapabilities(WebPartManager)

    Restituisce un dizionario contenente istanze WebPartUserCapability che rappresentano le funzionalità correlate alla personalizzazione dell'account utente attualmente in esecuzione.Returns a dictionary containing WebPartUserCapability instances that represent the personalization-related capabilities of the currently executing user account.

    Equals(Object)

    Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

    (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.When overridden in a derived class, returns a collection containing zero or more PersonalizationStateInfo-derived objects based on scope and specific query parameters.

    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.When overridden in a derived class, returns the number of rows in the underlying data store that exist within the specified scope.

    GetHashCode()

    Funge da funzione hash predefinita.Serves as the default hash function.

    (Ereditato da Object)
    GetType()

    Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

    (Ereditato da Object)
    Initialize(String, NameValueCollection)

    Inizializza il generatore di configurazione.Initializes the configuration builder.

    (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.When overridden in a derived class, loads raw personalization data from the underlying data store.

    LoadPersonalizationState(WebPartManager, Boolean)

    Carica i dati non elaborati dall'archivio dati sottostante e li converte in un oggetto PersonalizationState.Loads the raw data from the underlying data store and converts that data into a PersonalizationState object.

    MemberwiseClone()

    Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

    (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.When overridden in a derived class, deletes raw personalization data from the underlying data store.

    ResetPersonalizationState(WebPartManager)

    Reimposta i dati sulla personalizzazione nell'archivio dati sottostante.Resets personalization data to the underlying data store.

    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.When overridden in a derived class, deletes personalization state from the underlying data store based on the specified parameters.

    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.When overridden in a derived class, deletes Web Parts personalization data from the underlying data store based on the specified parameters.

    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.When overridden in a derived class, saves raw personalization data to the underlying data store.

    SavePersonalizationState(PersonalizationState)

    Salva i dati sulla personalizzazione in un archivio dati.Saves personalization data to a data store.

    ToString()

    Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

    (Ereditato da Object)

    Si applica a

    Vedi anche