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

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

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

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

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

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

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

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

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

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