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объекты, производные от SharedPersonalizationStateInfo типа или .UserPersonalizationStateInfo С помощью поставщика 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персонализации по умолчанию производные объекты возвращаются в алфавитном порядке и сортируются по сочетанию пути и имени пользователя в порядке возрастания. Порядок объектов в коллекции определяется поставщиком.

См. также раздел

Применяется к