AuthenticatingEventArgs Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет данные о событии Authenticating.
public ref class AuthenticatingEventArgs : EventArgs
public class AuthenticatingEventArgs : EventArgs
type AuthenticatingEventArgs = class
inherit EventArgs
Public Class AuthenticatingEventArgs
Inherits EventArgs
- Наследование
Примеры
В следующем примере показан обработчик событий, который передает UserName значения и в Password настраиваемый поставщик членства для проверки учетных данных пользователя. Обработчик событий задает Authenticated возвращаемое значение ValidateUser метода и задает значение AuthenticationIsComplete , true
AuthenticationService чтобы класс не проверял учетные данные.
void AuthenticationService_Authenticating(object sender, System.Web.ApplicationServices.AuthenticatingEventArgs e)
{
if (e.UserName.IndexOf("@contoso.com") >= 0)
{
e.Authenticated = Membership.Providers["ContosoSqlProvider"].ValidateUser(e.UserName, e.Password);
}
else if (e.UserName.IndexOf("@fabrikam.com") >= 0)
{
e.Authenticated = Membership.Providers["FabrikamSqlProvider"].ValidateUser(e.UserName, e.Password);
}
else
{
e.Authenticated = Membership.Provider.ValidateUser(e.UserName, e.Password);
}
e.AuthenticationIsComplete = true;
}
Sub AuthenticationService_Authenticating _
(ByVal sender As Object, _
ByVal e As System.Web.ApplicationServices.AuthenticatingEventArgs)
If (e.Username.IndexOf("@contoso.com") >= 0) Then
e.Authenticated = Membership.Providers("ContosoSqlProvider").ValidateUser(e.Username, e.Password)
ElseIf (e.Username.IndexOf("@fabrikam.com") >= 0) Then
e.Authenticated = Membership.Providers("FabrikamSqlProvider").ValidateUser(e.Username, e.Password)
Else
e.Authenticated = Membership.Provider.ValidateUser(e.Username, e.Password)
End If
e.AuthenticationIsComplete = True
End Sub
Комментарии
Обработчик для Authenticating события создается, если требуется настроить способ проверки подлинности учетных данных пользователя во время выполнения. Класс AuthenticatingEventArgs предоставляет значения любому Authenticating обработчику событий. С помощью свойств, доступных в этом классе, можно получить учетные данные пользователя для настройки проверки подлинности.
Класс AuthenticationService вызывает Authenticating событие перед проверкой учетных данных пользователя. Класс AuthenticationService создает экземпляр AuthenticatingEventArgs объекта и передает его в любой Authenticating обработчик событий.
Для получения учетных UserNameданных пользователя можно использовать свойства , Password и CustomCredential . Свойство CustomCredential может содержать дополнительные значения, необходимые для проверки подлинности, например идентификационный номер.
Свойство Authenticated указывает, допустимы ли учетные данные пользователя. Для свойства задается Authenticated результат настраиваемой проверки подлинности. Кроме того, свойство имеет AuthenticationIsComplete значение true
, если вы проверили учетные данные пользователя и не хотите AuthenticationService , чтобы класс проверял учетные данные пользователя через поставщика членства по умолчанию.
Свойства
Authenticated |
Возвращает или задает значение, позволяющее определить, допустимы ли учетные данные пользователя. |
AuthenticationIsComplete |
Возвращает или задает значение, позволяющее определить, прошли ли учетные данные пользователя проверку подлинности. |
CustomCredential |
Возвращает дополнительные значения, связанные с пользователем, для проверки подлинности. |
Password |
Возвращает пароль пользователя. |
UserName |
Возвращает имя проверки подлинности для пользователя. |
Методы
Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |