語言

PersonalizationAdministration.GetAllState 方法

定義

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

回傳來自底層資料庫中所有個人化狀態資訊的集合，針對所請求的個人化範圍及其他指定參數。

多載

名稱 Description
GetAllState(PersonalizationScope)

回傳來自底層資料庫中所有個人化狀態資訊的集合，針對所請求的個人化範圍。
GetAllState(PersonalizationScope, Int32, Int32, Int32)

根據指定的參數，從底層資料儲存庫回傳所有個人化狀態資訊的子集。

GetAllState(PersonalizationScope)

回傳來自底層資料庫中所有個人化狀態資訊的集合，針對所請求的個人化範圍。

public:
 static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ GetAllState(System::Web::UI::WebControls::WebParts::PersonalizationScope scope);
public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection GetAllState(System.Web.UI.WebControls.WebParts.PersonalizationScope scope);
static member GetAllState : System.Web.UI.WebControls.WebParts.PersonalizationScope -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public Shared Function GetAllState (scope As PersonalizationScope) As PersonalizationStateInfoCollection

參數

scope
PersonalizationScope

要擷取的個人化資訊範圍。

傳回

PersonalizationStateInfoCollection

包含 PersonalizationStateInfoCollection 指定範圍的狀態資訊。

例外狀況

ArgumentException

設定中定義的個人化提供者的提供者類型不正確。

ConfigurationErrorsException

在嘗試建立並初始化其中一個已設定個人化提供者的實例時，發生了設定異常。

-或-

無法找到設定中定義的預設個人化提供者。

ArgumentOutOfRangeException

scope 不屬於列舉的有效成員 PersonalizationScope 。

備註

請注意，回傳的集合僅 PersonalizationStateInfo包含 類型或類型 SharedPersonalizationStateInfoUserPersonalizationStateInfo的 -導出物件。 使用預設的個人化服務提供者， PersonalizationStateInfo導出的物件會依字母順序回傳，並依路徑與使用者名稱組合，從序至高排序。 集合中物件的順序由提供者決定。

另請參閱

適用於

GetAllState(PersonalizationScope, Int32, Int32, Int32)

根據指定的參數，從底層資料儲存庫回傳所有個人化狀態資訊的子集。

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

參數

scope
PersonalizationScope

要擷取的個人化資訊範圍。

pageIndex
Int32

結果頁面的零基索引。

pageSize
Int32

要傳回的記錄數目。

totalRecords
Int32

可用紀錄總數。

傳回

PersonalizationStateInfoCollection

包含 PersonalizationStateInfoCollection 指定範圍與參數的狀態資訊。

例外狀況

ArgumentException

pageIndex 小於零。

-或-

pageSize 小於或等於零。

-或-

設定中定義的個人化提供者的提供者類型不正確。

-或-

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

ArgumentOutOfRangeException

scope 不屬於列舉的有效成員 PersonalizationScope 。

ConfigurationErrorsException

在嘗試建立並初始化其中一個已設定個人化提供者的實例時，發生了設定異常。

-或-

無法找到設定中定義的預設個人化提供者。

備註

回傳的集合項目主要基於範圍，然後對應該範圍的紀錄會根據 和 pageIndex 參數進一步縮減為子集pageSize。 回傳的集合要麼 SharedPersonalizationStateInfo 只包含實例，要麼 UserPersonalizationStateInfo 只包含實例。

回傳的項目受限 pageIndex 於 和 pageSize 參數，其中 pageIndex 控制回傳哪些記錄，並 pageSize 控制回傳的記錄數量。 例如，若 pageIndex 設為 0，且 pageSize 設為 25，則回傳的資料將是前 25 個條目。 若 pageIndex 設為 1，且 pageSize 設為 25，則回傳的資料將為第 26 至 50 條目。 參數 totalRecords 回傳可用紀錄的總數。

使用預設的個人化服務提供者， PersonalizationStateInfo導出的物件會依字母順序回傳，並依路徑與使用者名稱組合，從序至高排序。 集合中物件的順序由提供者決定。

另請參閱

適用於