PersonalizationAdministration.FindInactiveUserState 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
根據指定的參數，為非作用中使用者傳回每一使用者個人化狀態資訊的集合。
多載
| FindInactiveUserState(String, String, DateTime) |
根據指定的參數，為非作用中使用者傳回每一使用者個人化狀態資訊的集合。 |
| FindInactiveUserState(String, String, DateTime, Int32, Int32, Int32) |
根據指定的參數，為非作用中使用者傳回每一使用者個人化狀態資訊的集合。 |
FindInactiveUserState(String, String, DateTime)
根據指定的參數，為非作用中使用者傳回每一使用者個人化狀態資訊的集合。
public:
static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindInactiveUserState(System::String ^ pathToMatch, System::String ^ usernameToMatch, DateTime userInactiveSinceDate);public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindInactiveUserState (string pathToMatch, string usernameToMatch, DateTime userInactiveSinceDate);static member FindInactiveUserState : string * string * DateTime -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollectionPublic Shared Function FindInactiveUserState (pathToMatch As String, usernameToMatch As String, userInactiveSinceDate As DateTime) As PersonalizationStateInfoCollection參數
- pathToMatch
- String
符合的網頁路徑。
- usernameToMatch
- String
符合的使用者名稱，其中包括與網頁相關聯的個人化資料。
- userInactiveSinceDate
- DateTime
上次存取使用者個人化資訊的日期。
傳回
PersonalizationStateInfoCollection，包含每一使用者個人化狀態資訊。
例外狀況
pathToMatch 或 usernameToMatch 於修剪前後為空字串 ("")。
-或-
組態中定義的個人化提供者之提供者不是正確的型別。
-或-
任一參數的字串長度大於 256 個字元。
備註
這個方法會傳回實例集合 UserPersonalizationStateInfo 、每個使用者個人化狀態資訊，其中 pathToMatch 參數值符合頁面的路徑、 usernameToMatch 符合與該頁面相關聯的個人化數據的用戶名稱，且用戶被視為非使用中。 換句話說，針對每個傳回的 LastActivityDate 記錄，使用者的屬性值小於或等於 userInactiveSinceDate。 傳回的集合只 UserPersonalizationStateInfo 包含 實例。
此方法會將查詢通配符傳遞至基礎數據存放區。 通配符的支援目前取決於每個提供者如何處理星號 (*) 、百分比符號 ( ) %) 或底線 (_) 。
一般而言，針對符合 SQL 規範的數據存放區，您可以在部分路徑上執行通配符搜尋，其中通配符會出現在 屬性的 PathToMatch 開頭、結尾或搜尋字串文字中間。 例如，若要尋找以 “~/vdir” 開頭的所有路徑， PathToMatch 屬性會設定為 “~/vdir%”。
同樣地，部分用戶名稱上的通配符搜尋可能會讓通配符出現在屬性的文字字串 UsernameToMatch 中的任何一點。 例如，若要尋找開頭為 「John」 的所有使用者名稱， UsernameToMatch 屬性看起來會像 「John%」。
使用預設個人化提供者時， PersonalizationStateInfo衍生物件會依字母順序傳回，並以路徑和使用者名稱的組合來依遞增順序排序。 集合中對象的順序是由提供者決定。
如果 userInactiveSinceDate 為 MaxValue，則這個方法傳回的值相當於 FindUserState。
pathToMatch與 usernameToMatch 可以是 null。 參數 usernameToMatch 可以包含逗號 (，) ，因為某些數據存放區，例如執行 Microsoft SQL Server 的數據存放區，允許逗號做為通配符。
另請參閱
適用於
FindInactiveUserState(String, String, DateTime, Int32, Int32, Int32)
根據指定的參數，為非作用中使用者傳回每一使用者個人化狀態資訊的集合。
public:
static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindInactiveUserState(System::String ^ pathToMatch, System::String ^ usernameToMatch, DateTime userInactiveSinceDate, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindInactiveUserState (string pathToMatch, string usernameToMatch, DateTime userInactiveSinceDate, int pageIndex, int pageSize, out int totalRecords);static member FindInactiveUserState : string * string * DateTime * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollectionPublic Shared Function FindInactiveUserState (pathToMatch As String, usernameToMatch As String, userInactiveSinceDate As DateTime, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As PersonalizationStateInfoCollection參數
- pathToMatch
- String
符合的網頁路徑。
- usernameToMatch
- String
符合的使用者名稱，其中包括與網頁相關聯的個人化資料。
- userInactiveSinceDate
- DateTime
上次存取個人化資訊的日期。
- pageIndex
- Int32
要傳回的結果網頁之以零起始的索引。
- pageSize
- Int32
要傳回的資料錄數。
- totalRecords
- Int32
可用的資料錄總數。
傳回
PersonalizationStateInfoCollection，包含每一使用者個人化狀態資訊。
例外狀況
pathToMatch 或 usernameToMatch 於修剪前後為空字串 ("")。
-或-
pageIndex 小於零
-或-
pageSize 小於或等於零。
-或-
和 pageSize 的組合pageIndex超過 Int32.MaxValue。
-或-
組態中定義的個人化提供者之提供者不是正確的型別。
-或-
任一參數的字串長度大於 256 個字元。
備註
這個方法會傳回實例集合 UserPersonalizationStateInfo 、每個使用者個人化狀態資訊，其中 pathToMatch 參數值符合頁面的路徑、 usernameToMatch 符合與該頁面相關聯的個人化數據的用戶名稱，且用戶被視為非使用中。 換句話說，針對每個傳回的 LastActivityDate 記錄，使用者的屬性值小於或等於 userInactiveSinceDate。 集合只 UserPersonalizationStateInfo 包含 實例。
此方法會將參數通配符傳遞至基礎個人化提供者，因此數據存放區如何處理這些字元，取決於提供者如何處理星號 (*) 、百分比符號 (%) 或底線 (_) 。
一般而言，針對符合 SQL 規範的數據存放區，您可以在部分路徑上執行通配符搜尋，其中通配符會出現在 屬性的 PathToMatch 開頭、結尾或搜尋字串文字中間。 例如，若要尋找以 “~/vdir” 開頭的所有路徑， PathToMatch 屬性會設定為 “~/vdir%”。
同樣地，部分用戶名稱上的通配符搜尋可能會讓通配符出現在屬性的文字字串 UsernameToMatch 中的任何一點。 例如，若要尋找開頭為 「John」 的所有使用者名稱， UsernameToMatch 屬性看起來會像 「John%」。
使用預設個人化提供者時， PersonalizationStateInfo衍生物件會依字母順序傳回，並以路徑和使用者名稱的組合來依遞增順序排序。 集合中對象的順序是由提供者決定。
如果 userInactiveSinceDate 為 MaxValue，則這個方法傳回的值相當於 FindUserState。
pathToMatch與 usernameToMatch 可以是 null。 參數 usernameToMatch 可以有逗號 (，) ，因為某些數據存放區，例如執行 Microsoft SQL Server 的數據存放區，允許逗號做為通配符。
傳回的數據受限於 pageIndex 和 ，其中 pageIndex 會控制要傳回哪些記錄，以及pageSize控制要傳回pageSize的記錄數目。 例如，如果 pageIndex 設定為 0 且 pageSize 設定為 25，則傳回的數據會是前 25 個專案。 如果 pageIndex 設定為 1 且 pageSize 設定為 25，則傳回的數據會是專案 26 到 50。 參數 totalRecords 會傳回可用的記錄總數。
