PersonalizationAdministration.GetCountOfInactiveUserState 方法

  • 參考

定義

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

為非作用中使用者傳回基礎資料存放區中每一使用者個人化項目的計數。

多載

GetCountOfInactiveUserState(DateTime)

根據指定的參數，為非作用中使用者傳回基礎資料存放區中每一使用者個人化項目的計數。
GetCountOfInactiveUserState(String, DateTime)

根據指定的參數，為非作用中使用者傳回基礎資料存放區中每一使用者個人化項目的計數。

GetCountOfInactiveUserState(DateTime)

根據指定的參數，為非作用中使用者傳回基礎資料存放區中每一使用者個人化項目的計數。

public:
 static int GetCountOfInactiveUserState(DateTime userInactiveSinceDate);
public static int GetCountOfInactiveUserState (DateTime userInactiveSinceDate);
static member GetCountOfInactiveUserState : DateTime -> int
Public Shared Function GetCountOfInactiveUserState (userInactiveSinceDate As DateTime) As Integer

參數

userInactiveSinceDate
DateTime

上次存取使用者個人化資訊的日期。

傳回

Int32

非作用中使用者的個人化項目數目。

例外狀況

ArgumentException

組態中定義的個人化提供者之提供者不是正確的型別。

-或-

任一參數的字串長度大於 256 個字元。

ConfigurationErrorsException

在嘗試建立及初始化其中一個設定的個人化提供者的執行個體時，發生組態例外狀況。

-或-

找不到組態中定義的預設個人化提供者。

HttpException

預設提供者傳回的負數計數。

備註

這個方法會傳回使用者 LastActivityDate 屬性值小於或等於屬性值的 UserInactiveSinceDate 記錄。 如果 UserInactiveSinceDate 設定為 MaxValue ，則會傳回所有使用者的個人化資訊計數。

另請參閱

適用於

GetCountOfInactiveUserState(String, DateTime)

根據指定的參數，為非作用中使用者傳回基礎資料存放區中每一使用者個人化項目的計數。

public:
 static int GetCountOfInactiveUserState(System::String ^ pathToMatch, DateTime userInactiveSinceDate);
public static int GetCountOfInactiveUserState (string pathToMatch, DateTime userInactiveSinceDate);
static member GetCountOfInactiveUserState : string * DateTime -> int
Public Shared Function GetCountOfInactiveUserState (pathToMatch As String, userInactiveSinceDate As DateTime) As Integer

參數

pathToMatch
String

具有要擷取之個人化狀態資訊的網頁路徑。

userInactiveSinceDate
DateTime

上次存取使用者個人化資訊的日期。

傳回

Int32

非作用中使用者之基礎資料存放區中每一使用者個人化項目的計數。

例外狀況

ArgumentException

pathToMatch 在修剪後為空白字串 ("")。

-或-

組態中定義的個人化提供者之提供者不是正確的型別。

-或-

任一參數的字串長度大於 256 個字元。

ConfigurationErrorsException

在嘗試建立及初始化其中一個設定的個人化提供者的執行個體時，發生組態例外狀況。

-或-

找不到組態中定義的預設個人化提供者。

HttpException

預設提供者傳回的負數計數。

備註

這個方法會傳回頁面符合指定 pathtoMatch 參數且使用者 LastActivityDate 屬性值小於或等於屬性值的 UserInactiveSinceDate 記錄。 如果 UserInactiveSinceDate 設定為 MaxValue ，則會傳回所有使用者的個人化資訊計數。

請注意，參數 pathToMatch 可以包含萬用字元。 方法會將萬用字元傳遞至基礎資料存放區。 萬用字元支援目前取決於每個提供者如何處理星號 (*) 、百分比符號 (%) 或底線 (_) 等字元。

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

參數 pathToMatch 可以是 null 。 如果設定為 null ，則會在執行查詢時忽略 參數。

另請參閱

適用於