PersonalizationAdministration.GetAllState 方法

  • 參考

定義

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

根據所要求的個人化範圍和其他指定的參數，傳回基礎資料存放區之所有個人化狀態資訊的集合。

多載

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 小於或等於零。

-或-

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

-或-

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

ArgumentOutOfRangeException

scope 不是 PersonalizationScope 列舉型別的有效成員。

ConfigurationErrorsException

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

-或-

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

備註

傳回之集合中的專案主要以範圍為基礎，然後對應至該範圍的記錄會進一步縮減為根據 和 pageSize 參數的 pageIndex 子集。 傳回的集合只 SharedPersonalizationStateInfo 包含實例或 UserPersonalizationStateInfo 實例。

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

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

另請參閱

適用於