Freigeben über

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

  • Referenz

Definition

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

Ü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 -> bool
Public Function Login (username As String, password As String, customCredential As String, isPersistent As Boolean) As Boolean

Parameter

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

Boolean

true, wenn Benutzeranmeldeinformationen gültig sind, andernfalls false.

Attribute
OperationContractAttribute

Ausnahmen

ArgumentNullException

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 , übergibt customCredentialaber nicht . Wenn ValidateUser zurückgibt 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 hinaus dauert.

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 nicht vom Standardmitgliedschaftsanbieter überprüft. Erstellen Sie zum Anpassen des Authentifizierungscookies einen Ereignishandler für CreatingCookie.

Hinweis

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-Authentifizierung.

Gilt für:

Weitere Informationen