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 -> 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
true
jeśli poświadczenia użytkownika są prawidłowe; w przeciwnym razie , false
.
- Atrybuty
Wyjątki
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 customCredential
elementu . Jeśli ValidateUser zwraca true
wartość , 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).