AuthenticationService.Login(String, String, String, Boolean) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überprüft Benutzeranmeldeinformationen und erstellt ein Authentifizierungsticket (Cookie), wenn die Anmeldeinformationen gültig sind.
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 BooleanParameter
- username
- String
Der zu überprüfende Benutzername.
- password
- String
Das Kennwort für den angegebenen Benutzer.
- customCredential
- String
Die Werte, die zusätzlich zu username und password überprüft werden sollen, sofern vorhanden.
- isPersistent
- Boolean
Ein Wert, der angibt, ob das Authentifizierungsticket über Sitzungen hinaus gültig bleibt.
Gibt zurück
true, wenn Benutzeranmeldeinformationen gültig sind, andernfalls false.
- Attribute
Ausnahmen
userName oder password ist null.
Hinweise
Die Login Methode überprüft Benutzeranmeldeinformationen über einen Mitgliedschaftsanbieter. Sie können den Standardmitgliedschaftsanbieter verwenden oder zur Laufzeit einen benutzerdefinierten Mitgliedschaftsanbieter angeben. Die AuthenticationService -Klasse übergibt userName und password an die -Methode des Mitgliedschaftsanbieters ValidateUser , übergibt customCredentialaber nicht . Wenn ValidateUser zurückgegeben wird true, AuthenticationService wird ein Authentifizierungsticket als Cookie erstellt. Legen Sie den isPersistent Parameter auf fest true , um ein Authentifizierungsticket zu erstellen, das über die aktuelle Sitzung hinausgeht.
Hinweis
Verwenden Sie immer den Authentifizierungsdienst zusammen mit der Secure Sockets-Schicht (SSL, mit HTTPS), um vertrauliche Daten zu schützen.
Die Login -Methode löst das Authenticating Ereignis und das -Ereignis aus CreatingCookie . Erstellen Sie einen Ereignishandler für Authenticating , um die Authentifizierung anzupassen, z. B. das Überprüfen der Werte in customCredential oder das Überprüfen von Anmeldeinformationen über einen nicht standardmäßigen Mitgliedschaftsanbieter. Die Werte in customCredential werden vom Standardmitgliedschaftsanbieter nicht überprüft. Um das Authentifizierungscooky anzupassen, erstellen Sie einen Ereignishandler für CreatingCookie.
Hinweis
Rufen Sie die Login Methode nicht über Code auf, der auf dem Webserver ausgeführt wird. Sie rufen die Login -Methode nur als Teil eines WCF-Diensts auf. Weitere Informationen finden Sie unter ASP.NET-Authentifizierung.
