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

PersonalizationProvider.GetCountOfState Метод

Определение

Пространство имен:
System.Web.UI.WebControls.WebParts
Сборка:
System.Web.dll

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

public:
 abstract int GetCountOfState(System::Web::UI::WebControls::WebParts::PersonalizationScope scope, System::Web::UI::WebControls::WebParts::PersonalizationStateQuery ^ query);
public abstract int GetCountOfState(System.Web.UI.WebControls.WebParts.PersonalizationScope scope, System.Web.UI.WebControls.WebParts.PersonalizationStateQuery query);
abstract member GetCountOfState : System.Web.UI.WebControls.WebParts.PersonalizationScope * System.Web.UI.WebControls.WebParts.PersonalizationStateQuery -> int
Public MustOverride Function GetCountOfState (scope As PersonalizationScope, query As PersonalizationStateQuery) As Integer

Параметры

scope
PersonalizationScope

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

query
PersonalizationStateQuery

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

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

Int32

Количество строк в базовом хранилище данных, существующем для указанного scope параметра.

Комментарии

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

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

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

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

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

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

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

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

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

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

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

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