PersonalizationAdministration.FindSharedState 方法

  • 參考

定義

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

根據指定的參數傳回共用個人化狀態資訊的集合。

多載

FindSharedState(String)

根據指定的路徑傳回共用個人化狀態資訊的集合。
FindSharedState(String, Int32, Int32, Int32)

根據指定的參數傳回共用個人化狀態資訊的集合。

FindSharedState(String)

根據指定的路徑傳回共用個人化狀態資訊的集合。

public:
 static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindSharedState(System::String ^ pathToMatch);
public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindSharedState (string pathToMatch);
static member FindSharedState : string -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public Shared Function FindSharedState (pathToMatch As String) As PersonalizationStateInfoCollection

參數

pathToMatch
String

符合的網頁路徑。

傳回

PersonalizationStateInfoCollection

PersonalizationStateInfoCollection，包含共用的個人化狀態資訊。

例外狀況

ArgumentException

pathToMatch 於修剪前後為空字串 ("")。

-或-

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

-或-

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

ConfigurationErrorsException

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

-或-

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

備註

這個方法會傳回 實例集合， UserPersonalizationStateInfo 其中 pathToMatch 值符合共用個人化狀態資料之頁面的路徑。 集合只 SharedPersonalizationStateInfo 包含 實例。

此方法會將參數萬用字元傳遞至基礎個人化提供者，因此資料存放區如何處理這些字元，取決於提供者如何處理星號 (*) 、百分比符號 (%) 或底線 (_) 。

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

使用預設個人化提供者時， PersonalizationStateInfo 衍生物件會依字母順序傳回，並以路徑和使用者名稱的組合來依遞增順序排序。 集合中物件的排序是由提供者決定。

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

另請參閱

適用於

FindSharedState(String, Int32, Int32, Int32)

根據指定的參數傳回共用個人化狀態資訊的集合。

public:
 static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindSharedState(System::String ^ pathToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);
public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindSharedState (string pathToMatch, int pageIndex, int pageSize, out int totalRecords);
static member FindSharedState : string * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public Shared Function FindSharedState (pathToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As PersonalizationStateInfoCollection

參數

pathToMatch
String

符合的網頁路徑。

pageIndex
Int32

要傳回的結果網頁之以零起始的索引。

pageSize
Int32

要傳回的資料錄數。

totalRecords
Int32

可用的資料錄總數。

傳回

PersonalizationStateInfoCollection

PersonalizationStateInfoCollection，包含共用的個人化狀態資訊。

例外狀況

ArgumentException

pathToMatch 於修剪前後為空字串 ("")。

-或-

pageIndex 小於零。

-或-

pageSize 小於或等於零。

-或-

和 pageSize 的組合 pageIndex 超過Int32.MaxValue。

-或-

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

-或-

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

ConfigurationErrorsException

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

-或-

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

備註

這個方法會傳回 實例集合， UserPersonalizationStateInfo 其中 pathToMatch 值符合共用個人化狀態資料之頁面的路徑。 集合只 SharedPersonalizationStateInfo 包含 實例。

此方法會將參數萬用字元傳遞至基礎個人化提供者，因此資料存放區如何處理這些字元，取決於提供者如何處理星號 (*) 、百分比符號 (%) 或底線 (_) 。

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

使用預設個人化提供者時， PersonalizationStateInfo 衍生物件會依字母順序傳回，並以路徑和使用者名稱的組合來依遞增順序排序。 集合中物件的順序是由提供者決定。

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

傳回的資料受限於 pageIndex 和 ，其中 pageIndex 控制要傳回的記錄，並 pageSize 控制要傳回 pageSize 的記錄數目。 例如，如果 pageIndex 設定為 0 且 pageSize 設定為 25，則傳回的資料會是前 25 個專案。 如果 pageIndex 設定為 1 且 pageSize 設定為 25，則傳回的資料會是專案 26 到 50。 參數會 totalRecords 傳回可用的記錄總數。

另請參閱

適用於