PersonalizationProvider.FindState Метод

Определение

Пространство имен:

System.Web.UI.WebControls.WebParts

Сборка:

System.Web.dll

При переопределении в производном классе возвращает коллекцию, содержащую объекты, производные от PersonalizationStateInfo, на основании области и указанных параметров запроса.

public:
 abstract System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindState(System::Web::UI::WebControls::WebParts::PersonalizationScope scope, System::Web::UI::WebControls::WebParts::PersonalizationStateQuery ^ query, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);

public abstract System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindState (System.Web.UI.WebControls.WebParts.PersonalizationScope scope, System.Web.UI.WebControls.WebParts.PersonalizationStateQuery query, int pageIndex, int pageSize, out int totalRecords);

abstract member FindState : System.Web.UI.WebControls.WebParts.PersonalizationScope * System.Web.UI.WebControls.WebParts.PersonalizationStateQuery * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection

Public MustOverride Function FindState (scope As PersonalizationScope, query As PersonalizationStateQuery, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As PersonalizationStateInfoCollection

Параметры

scope

PersonalizationScope

Объект PersonalizationScope, содержащий данные персонализации для запроса. Это значение не может быть равно null.

query

PersonalizationStateQuery

Объект PersonalizationStateQuery, содержащий запрос. Это значение может быть равно null.

pageIndex

Int32

Место, где начинается выполнение запроса.

pageSize

Int32

Число возвращаемых записей.

totalRecords

Int32

Общее число доступных записей.

Возвращаемое значение

PersonalizationStateInfoCollection

Объект PersonalizationStateInfoCollection, содержащий объекты, производные от PersonalizationStateInfo.

Комментарии

Этот метод является абстрактным определением административного метода для запроса данных персонализации. Производные реализации должны соответствовать логике, описанной ниже.

Набор возвращаемых элементов ограничивается параметрами pageIndex и pageSize , где pageSize задает количество возвращаемых записей и pageIndex задает возвращаемые записи. Например, pageIndex значения 0 и pageSize 25 возвращают первые 25 вхождений, а pageIndex 1 и pageSize 25 — 26–50. Если вы хотите получить все доступные записи, задайте значение pageIndex 0 и pageSize значение MaxValue.

Объекты, производные PersonalizationStateInfoот объектов, возвращаются в алфавитном порядке и сортируются по сочетанию значений их Path свойств и Username в порядке возрастания.

Этот метод передает подстановочные знаки запроса в базовое хранилище данных. Поддержка подстановочных знаков в настоящее время зависит от того, как каждый поставщик обрабатывает такие символы, как звездочка (*), символ процента (%) или символ подчеркивания (_).

Обычно для хранилищ данных, совместимых с SQL, можно выполнить поиск с подстановочными знаками по частичному пути с подстановочным знаком, отображаемым в начале, конце или середине текста строки поиска в свойстве PathToMatch . Например, чтобы найти все пути, начинающиеся с "~/vdir", свойству PathToMatch будет присвоено значение "~/vdir%".

Аналогичным образом, при поиске с подстановочными знаками по частичному имени пользователя подстановочный знак может отображаться в любой точке текстовой UsernameToMatch строки свойства. Например, чтобы найти все имена пользователей, начинающиеся с "John", UsernameToMatch параметр будет выглядеть как "John%".

Применяются следующие ограничения запросов:

• Если указан только scope параметр и query имеет значение или все null свойства, query возвращаемые null значениями или по умолчанию, возвращаются все записи, соответствующие указанному scope параметру.

• PathToMatch Если свойство не nullравно , возвращаемые записи также фильтруются по путям, соответствующим значениюPathToMatch.

• UsernameToMatch Если свойство не nullравно , возвращаемые записи также фильтруются по именам пользователей, которые соответствуют значению UsernameToMatch свойства.

• UserInactiveSinceDate Если свойство не равно MaxValue, то возвращаемые записи также фильтруются для возврата только тех записей, которые связаны с неактивными пользователями. Сравнение включает записи, в которых LastActivityDate свойство меньше или равно свойству UserInactiveSinceDate .

Обратите внимание, что этот метод не проверяет сочетания параметров запроса. Например, код может запросить набор записей состояния персонализации, связанных с определенным именем пользователя в общем область. Так как имена пользователей не связаны с общими сведениями, возвращаемая коллекция будет пустой.

К сочетаниям параметров, которые могут возвращать непустую коллекцию, относятся:

• Sharedобласть в сочетании со свойством PathToMatch .

• Userобласть в сочетании со значениями для любого или всех PathToMatchсвойств , UsernameToMatchи UserInactiveSinceDate .