PersonalizationProvider Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Implementerar de grundläggande funktionerna för en personanpassningsprovider.
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- Arv
- Härledda
Kommentarer
Det här är den abstrakta basklassen som definierar de funktioner som krävs för en personanpassningsprovider. En personanpassningsprovider både läser in och lagrar anpassningsdata för en WebPartPersonalization instans räkning.
Basklassen definierar standardbeteende för ett antal metoder. endast de metoder som specifikt hanterar det underliggande datalagret markeras som abstrakta. Detta gör att en utvecklare kan skriva en anpassad provider för att interagera med ett specifikt datalager, utan att behöva implementera standardfunktioner som används av WebPartPersonalization klassen igen.
Anteckningar till implementerare
Du kan bara härleda från PersonalizationProvider och tillhandahålla implementeringar för de abstrakta metoder som definierats i den här klassen. De abstrakta metoderna handlar specifikt om att spara och läsa in data till ett fysiskt datalager och med administration av datalager. En anpassad provider måste kunna manipulera anpassningsinformation på ett sätt som skiljer Shared data från User data. Dessutom måste en provider segmentera personanpassningsdata efter sida och efter program.
Implementeringar av PersonalizationProvider är nära kopplade till implementeringar av PersonalizationState eftersom vissa anpassningsprovidermetoder returnerar instanser av PersonalizationState-härledda klasser. För att underlätta utvecklingen av anpassade leverantörer innehåller basklassen PersonalizationProvider en standardimplementering av anpassningslogik och serialiserings-/deserialiseringslogik som används direkt av WebPartPersonalization klassen. Därför kräver redigering av en anpassad provider enbart för att arbeta med ett annat datalager endast implementering av följande abstrakta metoder:
GetCountOfState(PersonalizationScope, PersonalizationStateQuery) – Den här metoden måste kunna räkna antalet rader med anpassningsdata i databasen för de angivna frågeparametrarna.
LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[]) – Med tanke på sökvägen och användarnamnet läser den här metoden in två binära stora objekt (BLOB) från databasen: en BLOB för delade data och en för användardata. Om du anger användarnamnet och sökvägen behöver WebPartManager du inte kontrollen för att komma åt sidinformationen som kan ange information om användarnamn/sökväg.
ResetPersonalizationBlob(WebPartManager, String, String) – Med tanke på sökvägen och användarnamnet tar den här metoden bort motsvarande rad i databasen. Om du anger användarnamnet och sökvägen behöver WebPartManager du inte kontrollen för att komma åt sidinformationen som kan ange information om användarnamn/sökväg.
SavePersonalizationBlob(WebPartManager, String, String, Byte[]) – Med tanke på sökvägen och användarnamnet sparar den här metoden den angivna BLOB:en till databasen. Om du anger användarnamnet och sökvägen behöver WebPartManager du inte kontrollen för att komma åt sidinformationen som kan ange information om användarnamn/sökväg.
I alla dessa metoder, om endast en sökväg anges, som anger att delade anpassningsdata för sidan körs på. Om både en sökväg och ett användarnamn skickas till en metod bör användaranpassningsdata för sidan hanteras. När det gäller LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[])bör delade data för den angivna sökvägen alltid läsas in, och du kan också läsa in användaranpassningsdata för sökvägen om användarnamnet inte nullär .
Alla andra abstrakta metoder är endast avsedda att användas i administrativa program och används inte av webbdelsinfrastrukturen vid körning. Ett exempel på en implementering av en personanpassningsprovider finns i SqlPersonalizationProvider klassen .
Konstruktorer
| Name | Description |
|---|---|
| PersonalizationProvider() |
Initierar en ny instans av PersonalizationProvider klassen. |
Egenskaper
| Name | Description |
|---|---|
| ApplicationName |
När det åsidosättas i en härledd klass hämtar eller anger du namnet på det program som konfigurerats för providern. |
| Description |
Hämtar en kort, vänlig beskrivning som är lämplig för visning i administrativa verktyg eller andra användargränssnitt (UIs). (Ärvd från ProviderBase) |
| Name |
Hämtar det eget namn som används för att referera till providern under konfigurationen. (Ärvd från ProviderBase) |
Metoder
| Name | Description |
|---|---|
| CreateSupportedUserCapabilities() |
Returnerar en lista över WebPartUserCapability objekt som representerar den uppsättning kända funktioner som används av webbdelskontrolluppsättningen. |
| DetermineInitialScope(WebPartManager, PersonalizationState) |
Avgör om det inledande anpassningsomfånget ska vara Shared eller User omfånget. |
| DetermineUserCapabilities(WebPartManager) |
Returnerar en ordlista som innehåller WebPartUserCapability instanser som representerar de anpassningsrelaterade funktionerna för det aktuella användarkontot som körs. |
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| FindState(PersonalizationScope, PersonalizationStateQuery, Int32, Int32, Int32) |
När den åsidosätts i en härledd klass returneras en samling som innehåller noll eller fler PersonalizationStateInfo-härledda objekt baserat på omfång och specifika frågeparametrar. |
| GetCountOfState(PersonalizationScope, PersonalizationStateQuery) |
När det åsidosätts i en härledd klass returneras antalet rader i det underliggande datalagret som finns inom det angivna omfånget. |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| Initialize(String, NameValueCollection) |
Initierar konfigurationsverktyget. (Ärvd från ProviderBase) |
| LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[]) |
När du åsidosättas i en härledd klass läser du in rådata för anpassning från det underliggande datalagret. |
| LoadPersonalizationState(WebPartManager, Boolean) |
Läser in rådata från det underliggande datalagret och konverterar dessa data till ett PersonalizationState objekt. |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| ResetPersonalizationBlob(WebPartManager, String, String) |
När de åsidosättas i en härledd klass tar bort rådata för anpassning från det underliggande datalagret. |
| ResetPersonalizationState(WebPartManager) |
Återställer anpassningsdata till det underliggande datalagret. |
| ResetState(PersonalizationScope, String[], String[]) |
När det åsidosätts i en härledd klass tar bort anpassningstillståndet från det underliggande datalagret baserat på de angivna parametrarna. |
| ResetUserState(String, DateTime) |
När de åsidosätts i en härledd klass tar bort webbdelars anpassningsdata från det underliggande datalagret baserat på de angivna parametrarna. |
| SavePersonalizationBlob(WebPartManager, String, String, Byte[]) |
När de åsidosättas i en härledd klass sparar du rådata för anpassning till det underliggande datalagret. |
| SavePersonalizationState(PersonalizationState) |
Sparar anpassningsdata i ett datalager. |
| ToString() |
Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object) |
