AuthenticationService.Login(String, String, String, Boolean) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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 -> boolPublic Function Login (username As String, password As String, customCredential As String, isPersistent As Boolean) As BooleanParametry
- username
- String
Nazwa użytkownika do zweryfikowania.
- password
- String
Hasło 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 ważny między sesjami.
Zwraca
true jeśli poświadczenia użytkownika są prawidłowe; w przeciwnym razie, false.
- Atrybuty
Wyjątki
userName lub password ma wartość 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 customCredentialmetody . Jeśli ValidateUser funkcja zwraca truewartość , AuthenticationService tworzy bilet uwierzytelniania jako plik cookie. Ustaw parametr na isPersistenttrue , aby utworzyć bilet uwierzytelniania, który trwa poza bieżącą sesją.
Note
Zawsze używaj usługi uwierzytelniania razem z bezpieczną warstwą gniazd (SSL, przy użyciu protokołu 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 poświadczeniach lub weryfikowanie poświadczeń za pośrednictwem dostawcy członkostwa innego niż domyślny. 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 programu CreatingCookie.
Note
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.
