PersonalizationAdministration.GetAllState Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает коллекцию всех данных состояния личных настроек из основного хранилища данных для запрошенной области персонализации и других указанных параметров.
Перегрузки
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, содержащая сведения о состоянии для указанной области.
Исключения
Поставщик, указанный в конфигурации в качестве поставщика персонализации, имеет неправильный тип.
При попытке создания и инициализации нового экземпляра одного из настроенных поставщиков персонализации получено исключение конфигурации.
-или-
Не удалось найти поставщик персонализации по умолчанию (определяется в конфигурации).
Параметр scope
не является допустимым элементом перечисления PersonalizationScope.
Комментарии
Обратите внимание, что возвращаемая коллекция содержит только PersonalizationStateInfoобъекты, производные от SharedPersonalizationStateInfo типа или .UserPersonalizationStateInfo С помощью поставщика PersonalizationStateInfoперсонализации по умолчанию производные объекты возвращаются в алфавитном порядке и сортируются по сочетанию пути и имени пользователя в порядке возрастания. Порядок объектов в коллекции определяется поставщиком.
См. также раздел
- WebPartPersonalization
- элементы управления веб-частей ASP.NET
- Обзор персонализации веб-частей
- Пошаговое руководство. Реализация персонализации веб-частей с помощью пользовательского элемента управления
- Персонализация веб-частей
Применяется к
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, содержащая сведения о состоянии для указанных области и параметров.
Исключения
Значение параметра pageIndex
меньше нуля.
-или-
pageSize
меньше или равно нулю.
-или-
Поставщик, указанный в конфигурации в качестве поставщика персонализации, имеет неправильный тип.
-или-
Сочетание pageIndex
и pageSize
превышает значение Int32.MaxValue.
Параметр scope
не является допустимым элементом перечисления PersonalizationScope.
При попытке создания и инициализации нового экземпляра одного из настроенных поставщиков персонализации получено исключение конфигурации.
-или-
Не удалось найти поставщик персонализации по умолчанию (определяется в конфигурации).
Комментарии
Возвращаемые элементы коллекции основаны в основном на области, а затем записи, соответствующие этой области, далее сокращаются до подмножества на pageIndex
основе параметров и pageSize
. Возвращаемая коллекция содержит либо SharedPersonalizationStateInfo только экземпляры, либо UserPersonalizationStateInfo только экземпляры.
Возвращаемые элементы ограничены параметрами pageIndex
и pageSize
, где pageIndex
определяет, какие записи следует возвращать, а pageSize
также количество возвращаемых записей. Например, если pageIndex
задано значение 0, а pageSize
значение 25, то возвращаемые данные будут первыми 25 записями. Если pageIndex
задано значение 1, а pageSize
значение 25, то возвращаемые данные будут записями с 26 по 50. Параметр totalRecords
возвращает общее количество доступных записей.
С помощью поставщика PersonalizationStateInfoперсонализации по умолчанию производные объекты возвращаются в алфавитном порядке и сортируются по сочетанию пути и имени пользователя в порядке возрастания. Порядок объектов в коллекции определяется поставщиком.
См. также раздел
- WebPartPersonalization
- элементы управления веб-частей ASP.NET
- Обзор персонализации веб-частей
- Пошаговое руководство. Реализация персонализации веб-частей с помощью пользовательского элемента управления
- Персонализация веб-частей