SqlPersonalizationProvider.GetCountOfState 方法

定義

命名空間:

System.Web.UI.WebControls.WebParts

組件:

System.Web.dll

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

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

參數

scope

PersonalizationScope

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

query

PersonalizationStateQuery

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

傳回

Int32

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

例外狀況

ArgumentException

PathToMatch 是非 null 的，且於修剪後為空字串 ("")。

-或-

值為非 null 時，PathToMatch 的長度會大於 256 個字元。

-或-

UsernameToMatch 是非 null 的，且於修剪後為空字串。

-或-

值為非 null 時，UsernameToMatch 的長度會大於 256 個字元。

ArgumentOutOfRangeException

指定的 scope 不是 PersonalizationScope 列舉中的有效值。

備註

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

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

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

適用下列查詢準則約束：

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

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

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

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

請注意，這個方法不會驗證查詢參數的組合。 例如，程式碼可以要求與共享範圍內非使用中使用者相關聯的狀態記錄計數。 因為沒有非作用中自訂的概念，所以傳回的計數會是零。

可能傳回非空白集合的參數組合包括：

• Shared 範圍與 結合 PathToMatch 。

• User 範圍與任何或所有 PathToMatch 、 UsernameToMatch 和 UserInactiveSinceDate 屬性的值結合。