AuthenticatingEventArgs.CustomCredential Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает дополнительные значения, связанные с пользователем, для проверки подлинности.
public:
property System::String ^ CustomCredential { System::String ^ get(); };
public string CustomCredential { get; }
member this.CustomCredential : string
Public ReadOnly Property CustomCredential As String
Значение свойства
Другие значения (помимо имени пользователя и пароля), необходимые для проверки подлинности.
Примеры
В следующем примере показан обработчик событий для Authenticating события, который анализирует два значения проверки подлинности CustomCredential из свойства . Он передает два значения, а также имя пользователя и пароль в пользовательский класс проверки подлинности с именем StudentAuthentication
.
void AuthenticationService_Authenticating(object sender, System.Web.ApplicationServices.AuthenticatingEventArgs e)
{
string studentid = String.Empty;
string answer = String.Empty;
string[] credentials =
e.CustomCredential.Split(new char[] { ',' });
if (credentials.Length > 0)
{
studentid = credentials[0];
if (credentials.Length > 1)
{
answer = credentials[1];
}
}
try
{
e.Authenticated =
StudentAuthentication.ValidateStudentCredentials
(e.UserName, e.Password, studentid, answer);
}
catch (ArgumentNullException ex)
{
e.Authenticated = false;
}
e.AuthenticationIsComplete = true;
}
Sub AuthenticationService_Authenticating _
(ByVal sender As Object, _
ByVal e As System.Web.ApplicationServices.AuthenticatingEventArgs)
Dim studentid As String = String.Empty
Dim answer As String = String.Empty
Dim credentials As String() = _
e.CustomCredential.Split(New Char() {","c})
If (credentials.Length > 0) Then
studentid = credentials(0)
If (credentials.Length > 1) Then
answer = credentials(1)
End If
End If
Try
e.Authenticated = _
StudentAuthentication.ValidateStudentCredentials _
(e.Username, e.Password, studentid, answer)
Catch ex As ArgumentNullException
e.Authenticated = False
End Try
e.AuthenticationIsComplete = True
End Sub
Комментарии
Свойство можно использовать для CustomCredential получения значений проверки подлинности, отличных от имени пользователя и пароля во время Authenticating события. Например, приложение может быть настроено для проверки идентификационного номера вместе с именем пользователя и паролем. В этом случае идентификационный номер будет передан в CustomCredential
параметре Login метода . Затем можно получить пользовательское значение с помощью CustomCredential свойства .
Свойство CustomCredential содержит настраиваемые значения в том же формате, в котором они передаются Login в метод . В обработчике Authenticating событий, если в свойстве хранится несколько значений, необходимо проанализировать значение CustomCredential свойства для получения значений.