AuthenticationService.Login(String, String, String, Boolean) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Проверяет учетные данные пользователя и создает билет проверки подлинности (файл 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 -> boolPublic 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
Значение, позволяющее определить, остается ли действительным билет проверки подлинности в различных сеансах.
Возвращаемое значение
Если учетные данные пользователя действительны, значение true, если нет, значение false.
- Атрибуты
Исключения
Параметр 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.
