Udostępnij przez

AuthenticationService.Login(String, String, String, Boolean) Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.ApplicationServices
Zestaw:
System.Web.Extensions.dll

Sprawdza poświadczenia użytkownika i tworzy bilet uwierzytelniania (cookie), jeśli poświadczenia są prawidłowe.

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

Parametry

username
String

Nazwa użytkownika do zweryfikowania.

password
String

Hasło dla określonego użytkownika.

customCredential
String

Wartość lub wartości do zweryfikowania oprócz username i password, jeśli istnieją.

isPersistent
Boolean

Wartość wskazująca, czy bilet uwierzytelniania pozostaje prawidłowy w ramach sesji.

Zwraca

Boolean

true jeśli poświadczenia użytkownika są prawidłowe; w przeciwnym razie , false.

Atrybuty
OperationContractAttribute

Wyjątki

ArgumentNullException

userName lub password to null.

Uwagi

Metoda Login weryfikuje poświadczenia użytkownika za pośrednictwem dostawcy członkostwa. Możesz użyć domyślnego dostawcy członkostwa lub określić niestandardowego dostawcę członkostwa w czasie wykonywania. Klasa AuthenticationService przekazuje userName metodę i password do metody dostawcy ValidateUser członkostwa, ale nie przekazuje customCredentialelementu . Jeśli ValidateUser zwraca truewartość , AuthenticationService tworzy bilet uwierzytelniania jako plik cookie. Ustaw parametr na isPersistent wartość , aby true utworzyć bilet uwierzytelniania, który trwa poza bieżącą sesją.

Uwaga

Zawsze używaj usługi uwierzytelniania razem z warstwą secure sockets (SSL, using HTTPS), aby chronić poufne dane.

Metoda Login zgłasza Authenticating zdarzenie i CreatingCookie zdarzenie. Utwórz procedurę obsługi zdarzeń, Authenticating aby dostosować uwierzytelnianie, takie jak sprawdzanie wartości w customCredential lub weryfikowanie poświadczeń za pośrednictwem innego niż domyślnego dostawcy członkostwa. Wartości w pliku customCredential nie są weryfikowane przez domyślnego dostawcę członkostwa. Aby dostosować plik cookie uwierzytelniania, utwórz procedurę obsługi zdarzeń dla CreatingCookieprogramu .

Uwaga

Nie należy wywoływać Login metody z kodu wykonywanego na serwerze sieci Web. Metoda jest wywoływana Login tylko w ramach usługi WCF. Aby uzyskać więcej informacji, zobacz ASP.NET Authentication (Uwierzytelnianie ASP.NET).

Dotyczy

Zobacz też