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

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 параметр будет выглядеть как "John%".

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

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

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

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

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

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

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

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