Share via

PersonalizationProvider.GetCountOfState 方法

  • 參考

定義

命名空間:
System.Web.UI.WebControls.WebParts
組件:
System.Web.dll

在衍生類別中覆寫時，會傳回特定範圍內存在的基礎資料存放區中的資料列數目。

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

參數

scope
PersonalizationScope

PersonalizationScope，含有要查詢的個人化資訊。 這個值不能是 null。

query
PersonalizationStateQuery

PersonalizationStateQuery，含有查詢。 這個值可以是 null。

傳回

Int32

基礎資料存放區中針對特定 scope 參數而存在的資料列數目。

備註

這個方法是擷取個人化資料計數的系統管理方法抽象定義。 衍生實作應遵循以下所述的邏輯。

這個方法會將查詢萬用字元傳遞至基礎資料存放區。 萬用字元的支援目前取決於每個提供者如何處理星號 (*) 、百分比符號 (%) 或底線 (_) 。

一般而言，對於符合 SQL 規範的資料存放區，您可以在部分路徑上執行萬用字元搜尋，其中萬用字元會出現在屬性的 PathToMatch 開頭、結尾或搜尋字串文字中間。 例如，若要尋找以 「~/vdir」 開頭的所有路徑，屬性 PathToMatch 會設定為 「~/vdir%」。

同樣地，部分使用者名稱的萬用字元搜尋可能會有萬用字元出現在屬性文字字串 UsernameToMatch 中的任何點。 例如，若要尋找以 「John」 開頭的所有使用者名稱， UsernameToMatch 參數看起來會像 「John%」。

適用下列查詢準則約束：

  • 如果只 scope 提供 ，而且 是 querynull 或 傳回 null 預設值的所有 query 屬性，則會計算符合指定 scope 參數的所有記錄。

  • PathToMatch如果 屬性不是 null ，則計數記錄也會根據符合 PathToMatch 值的路徑進行篩選。

  • UsernameToMatch如果屬性不是 null ，則計數記錄也會根據符合 UsernameToMatch 屬性值的使用者名稱進行篩選。

  • UserInactiveSinceDate如果 屬性不等於 MaxValue ，則會篩選計數記錄，只傳回與非作用中使用者相關聯的記錄。 比較包含屬性小於或等於 屬性的 UserInactiveSinceDate 記錄 LastActivityDate 。

請注意，這個方法不會驗證查詢參數的組合。 例如，程式碼可以要求與共享範圍中特定使用者名稱相關聯的個人化狀態記錄計數。 因為使用者名稱未與共享資訊相關聯，所以傳回的計數會是零。

可能傳回非零計數的參數組合包括：

適用於