PersonalizationProvider Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Implementuje základní funkce pro zprostředkovatele přizpůsobení.
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
- Dědičnost
- Odvozené
Poznámky
Toto je abstraktní základní třída, která definuje požadované funkce zprostředkovatele přizpůsobení. Zprostředkovatel přizpůsobení načítá a ukládá data přizpůsobení jménem WebPartPersonalization instance.
Základní třída definuje standardní chování pro řadu metod; Pouze ty metody, které se konkrétně zabývají podkladovým úložištěm dat, jsou označeny jako abstraktní. To umožňuje vývojáři napsat vlastního zprostředkovatele pro interakci s konkrétním úložištěm dat, aniž by bylo nutné znovu implementovat standardní funkce používané WebPartPersonalization třídou.
Poznámky pro implementátory
Můžete odvodit a PersonalizationProvider poskytnout implementace pouze pro abstraktní metody definované v této třídě. Abstraktní metody se zabývají konkrétně ukládáním a načítáním dat do fyzického úložiště dat a správou úložiště dat. Vlastní zprostředkovatel musí být schopen manipulovat s informacemi přizpůsobení způsobem, který odlišuje Shared data od User dat. Kromě toho musí poskytovatel segmentovat data přizpůsobení podle stránky i aplikace.
Implementace jsou úzce svázány PersonalizationProvider s implementacemi, PersonalizationState protože některé metody zprostředkovatele přizpůsobení vracejí instance -odvozených PersonalizationStatetříd. Pro usnadnění vývoje vlastních zprostředkovatelů PersonalizationProvider zahrnuje základní třída výchozí implementaci logiky přizpůsobení a logiky serializace/deserializace, která je používána přímo WebPartPersonalization třídou. V důsledku toho vytvoření vlastního poskytovatele výhradně pro účely práce s jiným úložištěm dat vyžaduje pouze implementaci následujících abstraktních metod:
GetCountOfState(PersonalizationScope, PersonalizationStateQuery) – Tato metoda musí být schopná spočítat počet řádků dat přizpůsobení v databázi pro zadané parametry dotazu.
LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[]) – Vzhledem k cestě a uživatelskému jménu tato metoda načte z databáze dva binární velké objekty (BLOB): jeden objekt BLOB pro sdílená data a jeden pro uživatelská data. Pokud zadáte uživatelské jméno a cestu, nepotřebujete WebPartManager ovládací prvek pro přístup k informacím o stránce, které mohou poskytnout informace o uživatelském jménu nebo cestě.
ResetPersonalizationBlob(WebPartManager, String, String) – Vzhledem k cestě a uživatelskému jménu tato metoda odstraní odpovídající řádek v databázi. Pokud zadáte uživatelské jméno a cestu, nepotřebujete WebPartManager ovládací prvek pro přístup k informacím o stránce, které mohou poskytnout informace o uživatelském jménu nebo cestě.
SavePersonalizationBlob(WebPartManager, String, String, Byte[]) – Vzhledem k cestě a uživatelskému jménu tato metoda uloží zadaný objekt BLOB do databáze. Pokud zadáte uživatelské jméno a cestu, nepotřebujete WebPartManager ovládací prvek pro přístup k informacím o stránce, které mohou poskytnout informace o uživatelském jménu nebo cestě.
Pokud je ve všech těchto metodách zadána pouze cesta, znamená to, že se na stránce provozují sdílená data přizpůsobení. Pokud jsou cestě i uživatelskému jménu předány do metody, mělo by se s daty přizpůsobení uživatele pro stránku pracovat. V případě LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[])nástroje by se měla vždy načíst sdílená data pro zadanou cestu a volitelně by se měla načíst také data přizpůsobení uživatele pro cestu, pokud uživatelské jméno není null
.
Všechny ostatní abstraktní metody jsou určeny pouze pro použití v aplikacích pro správu a nejsou používány infrastrukturou webových částí za běhu. Příklad implementace zprostředkovatele přizpůsobení najdete ve SqlPersonalizationProvider třídě .
Konstruktory
PersonalizationProvider() |
Inicializuje novou instanci PersonalizationProvider třídy. |
Vlastnosti
ApplicationName |
Při přepsání v odvozené třídě získá nebo nastaví název aplikace nakonfigurované pro zprostředkovatele. |
Description |
Získá stručný popis vhodný pro zobrazení v nástrojích pro správu nebo jiných uživatelských rozhraních (UI). (Zděděno od ProviderBase) |
Name |
Získá popisný název použitý k odkaz na poskytovatele během konfigurace. (Zděděno od ProviderBase) |
Metody
CreateSupportedUserCapabilities() |
Vrátí seznam WebPartUserCapability objektů, které představují sadu známých funkcí používaných sadou ovládacích prvků webových částí. |
DetermineInitialScope(WebPartManager, PersonalizationState) |
Určuje, zda má být Shared počáteční rozsah přizpůsobení nebo User obor. |
DetermineUserCapabilities(WebPartManager) |
Vrátí slovník obsahující WebPartUserCapability instance, které představují možnosti přizpůsobení související s aktuálně spuštěným uživatelským účtem. |
Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
FindState(PersonalizationScope, PersonalizationStateQuery, Int32, Int32, Int32) |
Při přepsání v odvozené třídě vrátí kolekci obsahující nula nebo více PersonalizationStateInfoodvozených objektů na základě oboru a konkrétních parametrů dotazu. |
GetCountOfState(PersonalizationScope, PersonalizationStateQuery) |
Při přepsání v odvozené třídě vrátí počet řádků v podkladovém úložišti dat, které existují v zadaném oboru. |
GetHashCode() |
Slouží jako výchozí hashovací funkce. (Zděděno od Object) |
GetType() |
Získá aktuální Type instanci. (Zděděno od Object) |
Initialize(String, NameValueCollection) |
Inicializuje tvůrce konfigurace. (Zděděno od ProviderBase) |
LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[]) |
Při přepsání v odvozené třídě načte nezpracovaná data přizpůsobení z podkladového úložiště dat. |
LoadPersonalizationState(WebPartManager, Boolean) |
Načte nezpracovaná data z podkladového úložiště dat a převede je na PersonalizationState objekt. |
MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object) |
ResetPersonalizationBlob(WebPartManager, String, String) |
Při přepsání v odvozené třídě odstraní nezpracovaná data přizpůsobení z podkladového úložiště dat. |
ResetPersonalizationState(WebPartManager) |
Obnoví data přizpůsobení do podkladového úložiště dat. |
ResetState(PersonalizationScope, String[], String[]) |
Při přepsání v odvozené třídě odstraní stav přizpůsobení z podkladového úložiště dat na základě zadaných parametrů. |
ResetUserState(String, DateTime) |
Při přepsání v odvozené třídě odstraní data přizpůsobení webových částí z podkladového úložiště dat na základě zadaných parametrů. |
SavePersonalizationBlob(WebPartManager, String, String, Byte[]) |
Při přepsání v odvozené třídě uloží nezpracovaná data přizpůsobení do podkladového úložiště dat. |
SavePersonalizationState(PersonalizationState) |
Uloží data přizpůsobení do úložiště dat. |
ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |