PersonalizationAdministration.GetCountOfUserState(String) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает количество элементов состояния персонализации в основном хранилище данных для указанного пользователя.
public:
static int GetCountOfUserState(System::String ^ usernameToMatch);public static int GetCountOfUserState (string usernameToMatch);static member GetCountOfUserState : string -> intPublic Shared Function GetCountOfUserState (usernameToMatch As String) As IntegerПараметры
- usernameToMatch
- String
Имя пользователя, связанное со сведениями о состоянии персонализации для извлечения.
Возвращаемое значение
Количество элементов состояния персонализации для указанного пользователя.
Исключения
Параметр usernameToMatch после усечения представляет собой пустую строку ("").
-или-
Поставщик, указанный в конфигурации в качестве поставщика персонализации, имеет неправильный тип.
-или-
Длина строки для любого параметра превышает 256 символов.
При попытке создания и инициализации нового экземпляра одного из настроенных поставщиков персонализации получено исключение конфигурации.
-или-
Не удалось найти поставщик персонализации по умолчанию (определяется в конфигурации).
Поставщик по умолчанию вернул отрицательное значение количества.
Комментарии
Этот метод возвращает количество элементов персонализации для каждого пользователя в базовом хранилище данных, которое существует для заданного usernameToMatch.
Обратите внимание, что usernameToMatch параметр может содержать подстановочные знаки. Этот метод передает подстановочные знаки в базовое хранилище данных. Поддержка подстановочных знаков в настоящее время зависит от того, как каждый поставщик обрабатывает символы, такие как звездочка (*), символ процента (%) или символ подчеркивания (_).
Обычно для хранилищ данных, совместимых с SQL, поиск с подстановочными знаками по частичному имени пользователя может содержать подстановочный знак в любой точке текстовой UsernameToMatch строки свойства. Например, чтобы найти все имена пользователей, которые начинаются с "John", UsernameToMatch параметр будет выглядеть как "John%".
Параметр usernameToMatch может иметь значение null. Если задано значение null, параметр игнорируется при выполнении запросов. Параметр usernameToMatch может содержать запятые (,), так как в некоторых хранилищах данных, таких как Microsoft SQL Server, запятые допускаются в качестве подстановочных знаков.
