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.

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

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