Sdílet prostřednictvím

PersonalizationProvider.GetCountOfState Metoda

Definice

Obor názvů:
System.Web.UI.WebControls.WebParts
Sestavení:
System.Web.dll

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.

public:
 abstract int GetCountOfState(System::Web::UI::WebControls::WebParts::PersonalizationScope scope, System::Web::UI::WebControls::WebParts::PersonalizationStateQuery ^ query);
public abstract int GetCountOfState(System.Web.UI.WebControls.WebParts.PersonalizationScope scope, System.Web.UI.WebControls.WebParts.PersonalizationStateQuery query);
abstract member GetCountOfState : System.Web.UI.WebControls.WebParts.PersonalizationScope * System.Web.UI.WebControls.WebParts.PersonalizationStateQuery -> int
Public MustOverride Function GetCountOfState (scope As PersonalizationScope, query As PersonalizationStateQuery) As Integer

Parametry

scope
PersonalizationScope

Informace PersonalizationScope o přizpůsobení, které se mají dotazovat. Tato hodnota nemůže být null.

query
PersonalizationStateQuery

A PersonalizationStateQuery obsahující dotaz. Tato hodnota může být null.

Návraty

Int32

Počet řádků v podkladovém úložišti dat, které existují pro zadaný scope parametr.

Poznámky

Tato metoda je abstraktní definice metody správy pro načítání počtu osobních údajů. Odvozené implementace by měly dodržovat logiku popsanou níže.

Tato metoda předá do podkladového úložiště dat zástupné znaky dotazu. Podpora zástupných znaků je v současné době závislá na tom, jak každý zprostředkovatel zpracovává znaky, jako je hvězdička (*), symbol procenta (%) nebo podtržítko (_).

V případě úložišť dat kompatibilních s SQL můžete obvykle provést vyhledávání se zástupnými znaky na částečné cestě se zástupnými znaky, které se zobrazí na začátku, na konci nebo uprostřed textu vyhledávacího řetězce ve PathToMatch vlastnosti. Chcete-li například najít všechny cesty začínající na ~/vdir, PathToMatch vlastnost by byla nastavena na ~/vdir%".

Podobně může vyhledávání zástupných znaků na částečném uživatelském jménu obsahovat zástupný znak v libovolném bodě v textovém řetězci UsernameToMatch vlastnosti. Pokud například chcete najít všechna uživatelská jména začínající na "John", UsernameToMatch bude parametr vypadat takto: "John%".

Platí následující omezení dotazu:

  • Pokud je k dispozici pouze scope a query jsou null nebo všechny vlastnosti při query vrácení buď null nebo výchozí hodnoty, všechny záznamy odpovídající zadanému scope parametru se počítají.

  • PathToMatch Pokud vlastnost není null, počítané záznamy jsou také filtrovány na základě cest, které odpovídají hodnotěPathToMatch.

  • UsernameToMatch Pokud vlastnost není null, počítané záznamy jsou také filtrovány na základě uživatelských jmen, které odpovídají hodnotě UsernameToMatch vlastnosti.

  • UserInactiveSinceDate Pokud se vlastnost nerovná MaxValue, počítané záznamy jsou také filtrovány tak, aby vracely pouze ty záznamy přidružené k neaktivním uživatelům. Porovnání zahrnuje záznamy, ve kterých LastActivityDate je vlastnost menší nebo rovna UserInactiveSinceDate vlastnosti.

Všimněte si, že tato metoda neověřuje kombinace parametrů dotazu. Kód může například požádat o počet záznamů stavu přizpůsobení přidružených ke konkrétnímu uživatelskému jménu ve sdíleném oboru. Vzhledem k tomu, že uživatelská jména nejsou přidružená ke sdíleným informacím, bude vrácený počet nulový.

Mezi kombinace parametrů, které mají potenciál vrátit nenulový počet, patří:

Platí pro