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
Der Wert oder die Werte, die zusätzlich zu username und password, falls vorhanden, überprüft werden sollen.
- isPersistent
- Boolean
Ein Wert, der angibt, ob das Authentifizierungsticket über Sitzungen hinweg gültig bleibt.
Gibt zurück
truewenn Benutzeranmeldeinformationen gültig sind; andernfalls . false
- Attribute
Ausnahmen
userName oder password ist null.
Hinweise
Die Login Methode überprüft Die 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 , wird jedoch nicht übergeben customCredential. Wenn ValidateUser zurückgegeben truewird, AuthenticationService wird ein Authentifizierungsticket als Cookie erstellt. Legen Sie den isPersistent Parameter fest, um ein Authentifizierungsticket zu true erstellen, das über die aktuelle Sitzung hinausgeht.
Note
Verwenden Sie immer den Authentifizierungsdienst zusammen mit der secure Sockets Layer (SSL, mithilfe von HTTPS), um vertrauliche Daten zu schützen.
Die Login Methode löst das Authenticating Ereignis und das CreatingCookie Ereignis aus. Erstellen Sie einen Ereignishandler zum Authenticating Anpassen der Authentifizierung, z. B. überprüfen Sie die Werte in customCredential oder überprüfen Sie Anmeldeinformationen über einen nicht standardmäßigen Mitgliedschaftsanbieter. Die Werte in customCredential werden vom Standardmäßigen Mitgliedschaftsanbieter nicht überprüft. Um das Authentifizierungscookies anzupassen, erstellen Sie einen Ereignishandler für CreatingCookie.
Note
Rufen Sie die Login Methode nicht aus 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 Authentication.
