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

SqlPersonalizationProvider.GetCountOfState Метод

Определение

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

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

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

Параметры

scope
PersonalizationScope

Значение PersonalizationScope , указывающее сведения о персонализации, которые необходимо запрашивать. Это значение не может быть равно null.

query
PersonalizationStateQuery

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

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

Int32

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

Исключения

ArgumentException

PathToMatch не являетсяnull пустой строкой ("") после обрезки.

–или–

Длина PathToMatch больше 256 символов, если значение не равноnull.

–или–

UsernameToMatch не являетсяnull пустой строкой после обрезки.

–или–

Длина UsernameToMatch больше 256 символов, если значение не равноnull.

ArgumentOutOfRangeException

Указанный scope параметр не является допустимым значением PersonalizationScope из перечисления.

Комментарии

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

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

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

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

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

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

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

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

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

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

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