Sdílet prostřednictvím

SqlPersonalizationProvider.GetCountOfState Metoda

Definice

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

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

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

Parametry

scope
PersonalizationScope

A PersonalizationScope indikující informace 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.

Výjimky

ArgumentException

PathToMatch je ne-null a je prázdný řetězec ("") po oříznutí.

nebo

Délka PathToMatch je větší než 256 znaků, pokud hodnota nenínull.

nebo

UsernameToMatch je ne-null a je prázdný řetězec po oříznutí.

nebo

Délka UsernameToMatch je větší než 256 znaků, pokud hodnota nenínull.

ArgumentOutOfRangeException

Zadaná scope hodnota není platná hodnota z výčtu PersonalizationScope .

Poznámky

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. Pokud například chcete najít všechny cesty začínající na ~/approot, PathToMatch vlastnost by byla nastavena na ~/approot%".

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, vrátí se všechny záznamy odpovídající zadanému scope parametru.

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

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

  • Pokud se UserInactiveSinceDate vlastnost nerovná MaxValue, vrácené 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ů o stavu přidružených k neaktivním uživatelům ve sdíleném oboru. Vzhledem k tomu, že neexistuje žádný koncept neaktivních přizpůsobení, vrácený počet by byl nula.

Mezi kombinace parametrů, které mají potenciál vrátit neprázdnou kolekci, patří:

Platí pro