Sdílet prostřednictvím

SqlPersonalizationProvider.GetCountOfState Metoda

  • Reference

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 označující informace o přizpůsobení, které mají být dotazovány. 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.

Výjimky

ArgumentException

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

-nebo-

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

-nebo-

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

-nebo-

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

ArgumentOutOfRangeException

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

Poznámky

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 ~/approot, PathToMatch vlastnost by byla nastavená na hodnotu ~/approot%.

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, 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.

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

  • Pokud se UserInactiveSinceDate vlastnost nerovná hodnotě MaxValue, vyfiltrují se také vrácené záznamy tak, aby vracely jenom ty 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ř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