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

Definitie

Naamruimte:
System.Web.ApplicationServices
Assembly:
System.Web.Extensions.dll

Controleert gebruikersreferenties en maakt een verificatieticket (cookie) als de referenties geldig zijn.

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

Parameters

username
String

De gebruikersnaam die moet worden gevalideerd.

password
String

Het wachtwoord voor de opgegeven gebruiker.

customCredential
String

De waarde of waarden die naast username en password, indien van toepassing, moeten worden gevalideerd.

isPersistent
Boolean

Een waarde die aangeeft of het verificatieticket geldig blijft in sessies.

Retouren

Boolean

true als gebruikersreferenties geldig zijn; anders, false.

Kenmerken
OperationContractAttribute

Uitzonderingen

ArgumentNullException

userName of password is null.

Opmerkingen

De Login methode valideert gebruikersreferenties via een lidmaatschapsprovider. U kunt de standaardlidmaatschapsprovider gebruiken of een aangepaste lidmaatschapsprovider opgeven tijdens runtime. De AuthenticationService klasse wordt doorgegeven userName en password aan de methode van ValidateUser de lidmaatschapsprovider, maar wordt niet doorgegeven customCredential. Als ValidateUser deze retourneert true, AuthenticationService maakt u een verificatieticket als een cookie. Stel de isPersistent parameter in om een verificatieticket te true maken dat langer duurt dan de huidige sessie.

Note

Gebruik altijd de verificatieservice samen met de secure sockets-laag (SSL, met behulp van HTTPS) om gevoelige gegevens te beveiligen.

Met Login de methode worden de Authenticating gebeurtenis en de CreatingCookie gebeurtenis gegenereerd. Maak een gebeurtenishandler voor Authenticating het aanpassen van verificatie, zoals het controleren van de waarden in customCredential of het valideren van referenties via een niet-standaardlidmaatschapsprovider. De waarden in customCredential worden niet gevalideerd door de standaardlidmaatschapsprovider. Als u de verificatiecookor wilt aanpassen, maakt u een gebeurtenis-handler voor CreatingCookie.

Note

Roep de Login methode niet aan vanuit code die wordt uitgevoerd op de webserver. U roept de Login methode alleen aan als onderdeel van een WCF-service. Zie ASP.NET Authentication voor meer informatie.

Van toepassing op

Zie ook