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, разрешают запятые как подстановочные знаки.