ProfileProvider.FindInactiveProfilesByUserName Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
При переопределении в производном классе извлекает данные профилей, дата последнего действия которых предшествует указанной дате или совпадает с ней, а имя пользователя совпадает с указанным именем пользователя.
public:
abstract System::Web::Profile::ProfileInfoCollection ^ FindInactiveProfilesByUserName(System::Web::Profile::ProfileAuthenticationOption authenticationOption, System::String ^ usernameToMatch, DateTime userInactiveSinceDate, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);public abstract System.Web.Profile.ProfileInfoCollection FindInactiveProfilesByUserName (System.Web.Profile.ProfileAuthenticationOption authenticationOption, string usernameToMatch, DateTime userInactiveSinceDate, int pageIndex, int pageSize, out int totalRecords);abstract member FindInactiveProfilesByUserName : System.Web.Profile.ProfileAuthenticationOption * string * DateTime * int * int * int -> System.Web.Profile.ProfileInfoCollectionPublic MustOverride Function FindInactiveProfilesByUserName (authenticationOption As ProfileAuthenticationOption, usernameToMatch As String, userInactiveSinceDate As DateTime, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As ProfileInfoCollectionПараметры
- authenticationOption
- ProfileAuthenticationOption
Одно из значений ProfileAuthenticationOption, с помощью которого можно задать возвращаемые типы профилей: анонимный, с проверкой подлинности или оба.
- usernameToMatch
- String
Имя пользователя для поиска.
- userInactiveSinceDate
- DateTime
Структура типа DateTime, определяющая, какие пользовательские профили считаются неактивными. Если значение LastActivityDate свойства профиля пользователя возникло до этой даты и времени включительно, профиль считается неактивным.
- pageIndex
- Int32
Индекс страницы возвращаемых результатов.
- pageSize
- Int32
Размер возвращаемой страницы результатов.
- totalRecords
- Int32
Когда метод возвращает управление, содержит общее число профилей.
Возвращаемое значение
Коллекция ProfileInfoCollection, содержащая данные неактивных профилей пользователей, имя пользователя которых соответствует предоставленному параметру usernameToMatch.
Примеры
В следующем примере кода показана сигнатура FindInactiveProfilesByUserName метода для реализации метода . Пример полной ProfileProvider реализации см. в разделе Практическое руководство. Создание и запуск примера поставщика профилей.
public override ProfileInfoCollection FindInactiveProfilesByUserName(
ProfileAuthenticationOption authenticationOption,
string usernameToMatch,
DateTime userInactiveSinceDate,
int pageIndex,
int pageSize,
out int totalRecords)
{
totalRecords = 0;
return new ProfileInfoCollection();
}
Public Overrides Function FindInactiveProfilesByUserName( _
ByVal authenticationOption As ProfileAuthenticationOption, _
ByVal usernameToMatch As String, _
ByVal userInactiveSinceDate As DateTime, _
ByVal pageIndex As Integer, _
ByVal pageSize As Integer, _
ByRef totalRecords As Integer) As ProfileInfoCollection
totalRecords = 0
Return New ProfileInfoCollection()
End Function
Комментарии
Метод FindInactiveProfilesByUserName используется для получения сведений о профилях неиспользуемых профилей пользователей для профилей, в которых имя пользователя соответствует указанному usernameToMatch параметру. Возвращаются только данные, applicationName указанные в файле конфигурации. Параметр authenticationOption указывает, выполняется ли поиск только анонимных профилей, только профилей, прошедших проверку подлинности, или всех профилей. Из искомых профилей — любой LastActivityDate профиль с объектом , который имеет значение указанного userInactiveSinceDate параметра или до нее возвращается.
Если источник данных поддерживает дополнительные возможности поиска, такие как подстановочные знаки, можно предоставить более широкие возможности поиска по именам пользователей.
Результаты, возвращаемые параметром , FindInactiveProfilesByUserName ограничены параметрами pageIndex и pageSize . Параметр pageSize определяет максимальное количество объектов, возвращаемых ProfileInfo в ProfileInfoCollection. Параметр pageIndex определяет, какую страницу результатов следует вернуть, где нуль определяет первую страницу. Параметр totalRecords — это out параметр, который имеет общее количество неактивных профилей пользователей для настроенного applicationNameобъекта на основе authenticationOption параметров и userInactiveSinceDate . Например, если для настроенного applicationNameпользователя используется 13 пользователей, а pageIndex значение равно 1 с значением pageSize 5, ProfileInfoCollection возвращаемый будет содержать возвращаемые неактивные профили с шестого по десятый. Параметру totalRecords будет присвоено значение 13.
