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

PersonalizationAdministration.GetCountOfUserState(String) Метод

  • Ссылка

Определение

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

Возвращает количество элементов состояния персонализации в основном хранилище данных для указанного пользователя.

public:
 static int GetCountOfUserState(System::String ^ usernameToMatch);
public static int GetCountOfUserState (string usernameToMatch);
static member GetCountOfUserState : string -> int
Public Shared Function GetCountOfUserState (usernameToMatch As String) As Integer

Параметры

usernameToMatch
String

Имя пользователя, связанное со сведениями о состоянии персонализации для извлечения.

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

Int32

Количество элементов состояния персонализации для указанного пользователя.

Исключения

ArgumentException

Параметр usernameToMatch после усечения представляет собой пустую строку ("").

-или-

Поставщик, указанный в конфигурации в качестве поставщика персонализации, имеет неправильный тип.

-или-

Длина строки для любого параметра превышает 256 символов.

ConfigurationErrorsException

При попытке создания и инициализации нового экземпляра одного из настроенных поставщиков персонализации получено исключение конфигурации.

-или-

Не удалось найти поставщик персонализации по умолчанию (определяется в конфигурации).

HttpException

Поставщик по умолчанию вернул отрицательное значение количества.

Комментарии

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

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

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

Параметр usernameToMatch может иметь значение null. Если задано значение null, параметр игнорируется при выполнении запросов. Параметр usernameToMatch может содержать запятые (,), так как в некоторых хранилищах данных, таких как Microsoft SQL Server, запятые допускаются в качестве подстановочных знаков.

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

См. также раздел