PersonalizationProvider Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Implémente les fonctionnalités de base d’un fournisseur de personnalisation.
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- Héritage
- Dérivé
Remarques
Il s’agit de la classe de base abstraite qui définit les fonctionnalités requises d’un fournisseur de personnalisation. Un fournisseur de personnalisation charge et stocke des données de personnalisation pour le compte d’une WebPartPersonalization instance.
La classe de base définit le comportement standard d’un certain nombre de méthodes ; seules les méthodes qui traitent spécifiquement du magasin de données sous-jacent sont marquées comme abstraites. Cela permet à un développeur d’écrire un fournisseur personnalisé pour interagir avec un magasin de données spécifique, sans avoir à réinscrire les fonctionnalités standard utilisées par la WebPartPersonalization classe.
Notes pour les responsables de l’implémentation
Vous pouvez dériver PersonalizationProvider et fournir des implémentations uniquement pour les méthodes abstraites définies dans cette classe. Les méthodes abstraites traitent spécifiquement de l’enregistrement et du chargement de données dans un magasin de données physique et de l’administration du magasin de données. Un fournisseur personnalisé doit être capable de manipuler des informations de personnalisation d’une manière qui distingue les Shared données des User données. En outre, un fournisseur doit segmenter les données de personnalisation par page et par application.
Les implémentations sont PersonalizationProvider étroitement couplées aux implémentations, car certaines méthodes de fournisseur de PersonalizationState personnalisation retournent des instances de PersonalizationStateclasses dérivées de -. Pour faciliter le développement de fournisseurs personnalisés, la PersonalizationProvider classe de base inclut une implémentation par défaut de la logique de personnalisation et de la logique de sérialisation/désérialisation utilisée directement par la WebPartPersonalization classe. Par conséquent, la création d’un fournisseur personnalisé uniquement à des fins d’utilisation d’un autre magasin de données nécessite uniquement l’implémentation des méthodes abstraites suivantes :
GetCountOfState(PersonalizationScope, PersonalizationStateQuery) - Cette méthode doit pouvoir compter le nombre de lignes de données de personnalisation dans la base de données pour les paramètres de requête fournis.
LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[]) - Compte tenu du chemin d’accès et du nom d’utilisateur, cette méthode charge deux objets blob binaires à partir de la base de données : un OBJET BLOB pour les données partagées et un pour les données utilisateur. Si vous fournissez le nom d’utilisateur et le chemin d’accès, vous n’avez pas besoin du WebPartManager contrôle pour accéder aux informations de page qui peuvent fournir les informations de nom d’utilisateur/chemin d’accès.
ResetPersonalizationBlob(WebPartManager, String, String) - Compte tenu du chemin d’accès et du nom d’utilisateur, cette méthode supprime la ligne correspondante dans la base de données. Si vous fournissez le nom d’utilisateur et le chemin d’accès, vous n’avez pas besoin du WebPartManager contrôle pour accéder aux informations de page qui peuvent fournir les informations de nom d’utilisateur/chemin d’accès.
SavePersonalizationBlob(WebPartManager, String, String, Byte[]) - Compte tenu du chemin d’accès et du nom d’utilisateur, cette méthode enregistre l’objet blob fourni dans la base de données. Si vous fournissez le nom d’utilisateur et le chemin d’accès, vous n’avez pas besoin du WebPartManager contrôle pour accéder aux informations de page qui peuvent fournir les informations de nom d’utilisateur/chemin d’accès.
Dans toutes ces méthodes, si seul un chemin d’accès est fourni, cela indique que les données de personnalisation partagées pour la page sont utilisées. Si un chemin d’accès et un nom d’utilisateur sont passés à une méthode, les données de personnalisation de l’utilisateur pour la page doivent être exécutées. Dans le cas de LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[]), les données partagées pour le chemin spécifié doivent toujours être chargées, et éventuellement les données de personnalisation de l’utilisateur pour le chemin d’accès doivent également être chargées si le nom d’utilisateur n’est pas null.
Toutes les autres méthodes abstraites sont destinées à être utilisées uniquement dans les applications administratives et ne sont pas utilisées par l’infrastructure de composants WebPart au moment de l’exécution. Pour obtenir un exemple d’implémentation d’un fournisseur de personnalisation, consultez la SqlPersonalizationProvider classe.
Constructeurs
| Nom | Description |
|---|---|
| PersonalizationProvider() |
Initialise une nouvelle instance de la classe PersonalizationProvider. |
Propriétés
| Nom | Description |
|---|---|
| ApplicationName |
En cas de substitution dans une classe dérivée, obtient ou définit le nom de l’application configurée pour le fournisseur. |
| Description |
Obtient une brève description conviviale adaptée à l’affichage dans les outils d’administration ou d’autres interfaces utilisateur (UIs). (Hérité de ProviderBase) |
| Name |
Obtient le nom convivial utilisé pour faire référence au fournisseur pendant la configuration. (Hérité de ProviderBase) |
Méthodes
| Nom | Description |
|---|---|
| CreateSupportedUserCapabilities() |
Retourne une liste d’objets qui représentent l’ensemble de fonctionnalités connues utilisées par le jeu de WebPartUserCapability contrôles Composants WebPart. |
| DetermineInitialScope(WebPartManager, PersonalizationState) |
Détermine si l’étendue de personnalisation initiale doit être Shared ou User étendue. |
| DetermineUserCapabilities(WebPartManager) |
Retourne un dictionnaire contenant des WebPartUserCapability instances qui représentent les fonctionnalités liées à la personnalisation du compte d’utilisateur en cours d’exécution. |
| Equals(Object) |
Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object) |
| FindState(PersonalizationScope, PersonalizationStateQuery, Int32, Int32, Int32) |
En cas de substitution dans une classe dérivée, retourne une collection contenant zéro ou plusieurs PersonalizationStateInfoobjets dérivés en fonction de l’étendue et des paramètres de requête spécifiques. |
| GetCountOfState(PersonalizationScope, PersonalizationStateQuery) |
En cas de substitution dans une classe dérivée, retourne le nombre de lignes dans le magasin de données sous-jacent qui existent dans l’étendue spécifiée. |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| Initialize(String, NameValueCollection) |
Initialise le générateur de configuration. (Hérité de ProviderBase) |
| LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[]) |
En cas de substitution dans une classe dérivée, charge les données de personnalisation brutes à partir du magasin de données sous-jacent. |
| LoadPersonalizationState(WebPartManager, Boolean) |
Charge les données brutes à partir du magasin de données sous-jacent et convertit ces données en objet PersonalizationState . |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| ResetPersonalizationBlob(WebPartManager, String, String) |
En cas de substitution dans une classe dérivée, supprime les données de personnalisation brutes du magasin de données sous-jacent. |
| ResetPersonalizationState(WebPartManager) |
Réinitialise les données de personnalisation au magasin de données sous-jacent. |
| ResetState(PersonalizationScope, String[], String[]) |
En cas de substitution dans une classe dérivée, supprime l’état de personnalisation du magasin de données sous-jacent en fonction des paramètres spécifiés. |
| ResetUserState(String, DateTime) |
En cas de substitution dans une classe dérivée, supprime les données de personnalisation des composants WebPart du magasin de données sous-jacent en fonction des paramètres spécifiés. |
| SavePersonalizationBlob(WebPartManager, String, String, Byte[]) |
En cas de substitution dans une classe dérivée, enregistre les données de personnalisation brutes dans le magasin de données sous-jacent. |
| SavePersonalizationState(PersonalizationState) |
Enregistre les données de personnalisation dans un magasin de données. |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |
