PersonalizationProvider Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Implementeert de basisfunctionaliteit voor een personalisatieprovider.
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
- Overname
- Afgeleid
Opmerkingen
Dit is de abstracte basisklasse die de vereiste functionaliteit van een personalisatieprovider definieert. Een personalisatieprovider laadt en slaat persoonlijke gegevens op namens een WebPartPersonalization exemplaar.
De basisklasse definieert standaardgedrag voor een aantal methoden; alleen methoden die specifiek betrekking hebben op het onderliggende gegevensarchief, worden gemarkeerd als abstract. Hierdoor kan een ontwikkelaar een aangepaste provider schrijven om te communiceren met een specifiek gegevensarchief, zonder dat de standaardfunctionaliteit die door de WebPartPersonalization klasse wordt gebruikt, opnieuw hoeft te worden geïmplementeerd.
Notities voor uitvoerders
U kunt alleen implementaties afleiden PersonalizationProvider en bieden voor alleen de abstracte methoden die in deze klasse zijn gedefinieerd. De abstracte methoden hebben specifiek betrekking op het opslaan en laden van gegevens naar een fysiek gegevensarchief en met het beheer van gegevensarchieven. Een aangepaste provider moet persoonlijke gegevens kunnen manipuleren op een manier die gegevens van Shared gegevens onderscheidtUser. Bovendien moet een provider persoonlijke gegevens op pagina en per toepassing segmenteren.
Implementaties van PersonalizationProvider zijn nauw gekoppeld aan implementaties PersonalizationState , omdat sommige methoden voor personalisatieproviders exemplaren van PersonalizationState-afgeleide klassen retourneren. Om de ontwikkeling van aangepaste providers te vereenvoudigen, bevat de PersonalizationProvider basisklasse een standaardimplementatie van de personalisatielogica en serialisatie-/deserialisatielogica die rechtstreeks door de WebPartPersonalization klasse wordt gebruikt. Als gevolg hiervan vereist het ontwerpen van een aangepaste provider alleen voor het werken met een ander gegevensarchief alleen de implementatie van de volgende abstracte methoden:
GetCountOfState(PersonalizationScope, PersonalizationStateQuery) - Deze methode moet het aantal rijen met persoonlijke gegevens in de database kunnen tellen voor de opgegeven queryparameters.
LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[]) - Op basis van het pad en de gebruikersnaam worden met deze methode twee binaire grote objecten (BLOBs) uit de database geladen: één BLOB voor gedeelde gegevens en één voor gebruikersgegevens. Als u de gebruikersnaam en het pad opgeeft, hebt u het WebPartManager besturingselement niet nodig om toegang te krijgen tot de paginagegevens die de gebruikersnaam/padgegevens kunnen opgeven.
ResetPersonalizationBlob(WebPartManager, String, String) - Op basis van het pad en de gebruikersnaam wordt met deze methode de bijbehorende rij in de database verwijderd. Als u de gebruikersnaam en het pad opgeeft, hebt u het WebPartManager besturingselement niet nodig om toegang te krijgen tot de paginagegevens die de gebruikersnaam/padgegevens kunnen opgeven.
SavePersonalizationBlob(WebPartManager, String, String, Byte[]) - Op basis van het pad en de gebruikersnaam slaat deze methode de opgegeven BLOB op in de database. Als u de gebruikersnaam en het pad opgeeft, hebt u het WebPartManager besturingselement niet nodig om toegang te krijgen tot de paginagegevens die de gebruikersnaam/padgegevens kunnen opgeven.
Als op al deze methoden alleen een pad wordt opgegeven, worden de gedeelde persoonlijke instellingen voor de pagina uitgevoerd. Als zowel een pad als een gebruikersnaam worden doorgegeven aan een methode, moeten de persoonlijke gegevens van de gebruiker voor de pagina worden uitgevoerd. In het geval van LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[]), moeten de gedeelde gegevens voor het opgegeven pad altijd worden geladen en optioneel moeten de persoonlijke gebruikersgegevens voor het pad ook worden geladen als de gebruikersnaam niet nullis.
Alle andere abstracte methoden zijn alleen bedoeld voor gebruik in beheertoepassingen en worden niet gebruikt door de infrastructuur voor webonderdelen tijdens runtime. Zie de SqlPersonalizationProvider klasse voor een voorbeeld van een implementatie van een personalisatieprovider.
Constructors
| Name | Description |
|---|---|
| PersonalizationProvider() |
Initialiseert een nieuw exemplaar van de PersonalizationProvider klasse. |
Eigenschappen
| Name | Description |
|---|---|
| ApplicationName |
Wanneer deze wordt overschreven in een afgeleide klasse, haalt of stelt u de naam in van de toepassing die voor de provider is geconfigureerd. |
| Description |
Hiermee krijgt u een korte, beschrijvende beschrijving die geschikt is voor weergave in beheerhulpprogramma's of andere gebruikersinterfaces (UIS's). (Overgenomen van ProviderBase) |
| Name |
Hiermee haalt u de beschrijvende naam op die wordt gebruikt om tijdens de configuratie naar de provider te verwijzen. (Overgenomen van ProviderBase) |
Methoden
| Name | Description |
|---|---|
| CreateSupportedUserCapabilities() |
Retourneert een lijst WebPartUserCapability met objecten die de set bekende mogelijkheden vertegenwoordigen die worden gebruikt door de besturingsset webonderdelen. |
| DetermineInitialScope(WebPartManager, PersonalizationState) |
Bepaalt of het initialisatiebereik moet zijn Shared of User het bereik. |
| DetermineUserCapabilities(WebPartManager) |
Retourneert een woordenlijst met WebPartUserCapability exemplaren die de mogelijkheden voor persoonlijke instellingen van het momenteel uitgevoerde gebruikersaccount vertegenwoordigen. |
| Equals(Object) |
Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object) |
| FindState(PersonalizationScope, PersonalizationStateQuery, Int32, Int32, Int32) |
Wanneer deze wordt overschreven in een afgeleide klasse, wordt een verzameling geretourneerd die nul of meer PersonalizationStateInfoafgeleide objecten bevat op basis van bereik en specifieke queryparameters. |
| GetCountOfState(PersonalizationScope, PersonalizationStateQuery) |
Wanneer deze wordt overschreven in een afgeleide klasse, wordt het aantal rijen in het onderliggende gegevensarchief geretourneerd dat binnen het opgegeven bereik bestaat. |
| GetHashCode() |
Fungeert als de standaardhashfunctie. (Overgenomen van Object) |
| GetType() |
Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object) |
| Initialize(String, NameValueCollection) |
Initialiseert de opbouwfunctie voor configuraties. (Overgenomen van ProviderBase) |
| LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[]) |
Wanneer deze worden overschreven in een afgeleide klasse, laadt u onbewerkte persoonlijke gegevens uit het onderliggende gegevensarchief. |
| LoadPersonalizationState(WebPartManager, Boolean) |
Laadt de onbewerkte gegevens uit het onderliggende gegevensarchief en converteert die gegevens naar een PersonalizationState object. |
| MemberwiseClone() |
Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object) |
| ResetPersonalizationBlob(WebPartManager, String, String) |
Wanneer deze worden overschreven in een afgeleide klasse, verwijdert u onbewerkte persoonlijke gegevens uit het onderliggende gegevensarchief. |
| ResetPersonalizationState(WebPartManager) |
Hiermee stelt u persoonlijke gegevens opnieuw in op het onderliggende gegevensarchief. |
| ResetState(PersonalizationScope, String[], String[]) |
Wanneer deze wordt overschreven in een afgeleide klasse, verwijdert u de persoonlijke status uit het onderliggende gegevensarchief op basis van de opgegeven parameters. |
| ResetUserState(String, DateTime) |
Wanneer deze worden overschreven in een afgeleide klasse, verwijdert u persoonlijke gegevens van webonderdelen uit het onderliggende gegevensarchief op basis van de opgegeven parameters. |
| SavePersonalizationBlob(WebPartManager, String, String, Byte[]) |
Wanneer deze worden overschreven in een afgeleide klasse, worden onbewerkte persoonlijke gegevens opgeslagen in het onderliggende gegevensarchief. |
| SavePersonalizationState(PersonalizationState) |
Slaat persoonlijke gegevens op in een gegevensarchief. |
| ToString() |
Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object) |