Поделиться через

AuthenticationService.Login(String, String, String, Boolean) Метод

  • Ссылка

Определение

Пространство имен:
System.Web.ApplicationServices
Сборка:
System.Web.Extensions.dll

Проверяет учетные данные пользователя и создает билет проверки подлинности (файл Cookie), если учетные данные оказываются действительными.

public:
 bool Login(System::String ^ username, System::String ^ password, System::String ^ customCredential, bool isPersistent);
[System.ServiceModel.OperationContract]
public bool Login (string username, string password, string customCredential, bool isPersistent);
[<System.ServiceModel.OperationContract>]
member this.Login : string * string * string * bool -> bool
Public Function Login (username As String, password As String, customCredential As String, isPersistent As Boolean) As Boolean

Параметры

username
String

Проверяемое имя пользователя.

password
String

Пароль заданного пользователя.

customCredential
String

Значение или значения, которые необходимо проверить в дополнение к параметрам username и password.

isPersistent
Boolean

Значение, позволяющее определить, остается ли действительным билет проверки подлинности в различных сеансах.

Возвращаемое значение

Boolean

Если учетные данные пользователя действительны, значение true, если нет, значение false.

Атрибуты
OperationContractAttribute

Исключения

ArgumentNullException

Параметр userName или password имеет значение null.

Комментарии

Метод Login проверяет учетные данные пользователя через поставщика членства. Вы можете использовать поставщика членства по умолчанию или указать настраиваемый поставщик членства во время выполнения. Класс AuthenticationService передает userName и password методу поставщика ValidateUser членства, но не передает customCredential. Если ValidateUser возвращает значение true, AuthenticationService создается запрос проверки подлинности в виде файла cookie. Задайте параметру isPersistent значение , true чтобы создать билет проверки подлинности, который длится после текущего сеанса.

Примечание

Всегда используйте службу проверки подлинности вместе со слоем безопасных сокетов (SSL, по протоколу HTTPS) для защиты конфиденциальных данных.

Метод Login вызывает Authenticating событие и CreatingCookie событие . Создайте обработчик событий для, Authenticating чтобы настроить проверку подлинности, например проверку значений в customCredential или проверку учетных данных с помощью поставщика членства, отличного от поставщика членства по умолчанию. Значения в customCredential не проверяются поставщиком членства по умолчанию. Чтобы настроить файл cookie проверки подлинности, создайте обработчик событий для CreatingCookie.

Примечание

Не вызывайте Login метод из кода, выполняемого на веб-сервере. Метод вызывается Login только в составе службы WCF. Дополнительные сведения см. в разделе проверка подлинности ASP.NET.

Применяется к

См. также раздел