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 rámci zadaného 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

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

query

PersonalizationStateQuery

Obsahující PersonalizationStateQuery 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í definicí metody správy pro načítání počtů dat přizpůsobení. Odvozené implementace by se měly řídit logikou popsanou níže.

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

Za normálních okolností můžete u úložišť dat kompatibilních s SQL provádět vyhledávání pomocí zástupných znaků na částečné cestě se zástupným znakem, který se zobrazuje na začátku, na konci nebo uprostřed textu hledaného řetězce ve PathToMatch vlastnosti . Pokud například chcete najít všechny cesty, které začínají na ~/vdir, PathToMatch vlastnost by byla nastavená na ~/vdir%.

Podobně při hledání pomocí zástupných znaků u částečného uživatelského jména se zástupný znak může objevit v libovolném bodě textového UsernameToMatch řetězce vlastnosti. Pokud například chcete najít všechna uživatelská jména začínající na "John", UsernameToMatch parametr by vypadal takto: "John%".

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

• Pokud je zadaný pouze scope parametr a query je null nebo všechny vlastnosti vrátí querynull jednu nebo výchozí hodnoty, započítá se všechny záznamy odpovídající zadanému scope parametru.

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

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

• Pokud se UserInactiveSinceDate vlastnost nerovná hodnotě MaxValue, vyfiltrují se také počítané záznamy, aby se vrátily pouze záznamy přidružené k neaktivním uživatelům. Porovnání zahrnuje záznamy, ve LastActivityDate kterých 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 vyžadovat počet záznamů o 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ří:

• Shared v kombinaci s PathToMatch vlastností .

• User v kombinaci s hodnotami pro libovolnou nebo všechny PathToMatchvlastnosti , UsernameToMatcha UserInactiveSinceDate .