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 обработчику событий.
Вы можете использовать UserNamePassword свойства и 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) |