Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. |
Übersetzung
Original
|
AuthenticationService.Login-Methode
Überprüft Benutzeranmeldeinformationen und erstellt ein Authentifizierungsticket (Cookie), wenn die Anmeldeinformationen gültig sind.
Assembly: System.Web.Extensions (in System.Web.Extensions.dll)
[OperationContractAttribute] public bool Login( string username, string password, string customCredential, bool isPersistent )
Parameter
- username
- Typ: System.String
Der zu überprüfende Benutzername.
- password
- Typ: System.String
Das Kennwort für den angegebenen Benutzer.
- customCredential
- Typ: System.String
Die Werte, die zusätzlich zu userName und password überprüft werden sollen, sofern vorhanden.
- isPersistent
- Typ: System.Boolean
Ein Wert, der angibt, ob das Authentifizierungsticket über Sitzungen hinaus gültig bleibt.
Rückgabewert
Typ: System.Booleantrue, wenn Benutzeranmeldeinformationen gültig sind, andernfalls false.
| Ausnahme | Bedingung |
|---|---|
| ArgumentNullException |
userName oder password ist null. |
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 ValidateUser-Methode des Mitgliedschaftsanbieters, nicht jedoch customCredential. Wenn ValidateUsertrue zurückgibt, erstellt AuthenticationService ein Authentifizierungsticket als Cookie. Legen Sie den isPersistent-Parameter auf true fest, um ein Authentifizierungsticket zu erstellen, das über die aktuelle Sitzung hinaus gültig ist.
Hinweis
|
|---|
|
Verwenden Sie den Authentifizierungsdienst stets zusammen mit SSL (Secure Sockets Layer, unter Verwendung 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 für Authenticating, um die Authentifizierung anzupassen, z. B. durch Überprüfen der Werte in customCredential oder Validieren der Anmeldeinformationen über einen nicht dem Standard entsprechenden Mitgliedschaftsanbieter. Die Werte in customCredential werden nicht vom Standardmitgliedschaftsanbieter überprüft. Zum Anpassen des Authentifizierungscookies erstellen Sie einen Ereignishandler für CreatingCookie.
|
Hinweis
|
|---|
|
Rufen Sie die Login-Methode nicht in auf dem Webserver ausgeführtem Code auf. Sie rufen die Login-Methode nur als Teil eines WCF-Diensts auf. Weitere Informationen finden Sie unter Authentifizierung in ASP.NET. |
Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
