Поделиться через

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 параметрами и pageSizepageSize задает количество записей для возврата и 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 параметр будет выглядеть следующим образом: "Джон%".

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

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

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

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

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

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

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

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