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

Definice

Obor názvů:

System.Web.ApplicationServices

Sestavení:

System.Web.Extensions.dll

Zkontroluje přihlašovací údaje uživatele a vytvoří ověřovací lístek (soubor cookie), pokud jsou přihlašovací údaje platné.

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

Parametry

username

String

Uživatelské jméno, které se má ověřit.

password

String

Heslo pro zadaného uživatele.

customCredential

String

Hodnota nebo hodnoty, které se mají ověřit kromě username a password, pokud jsou k dispozici.

isPersistent

Boolean

Hodnota, která určuje, jestli ověřovací lístek zůstane platný napříč relacemi.

Návraty

Boolean

truepokud jsou přihlašovací údaje uživatele platné; v opačném případě . false

Atributy

OperationContractAttribute

Výjimky

ArgumentNullException

userName nebo password je null.

Poznámky

Metoda Login ověřuje přihlašovací údaje uživatele prostřednictvím zprostředkovatele členství. Můžete použít výchozího zprostředkovatele členství nebo zadat vlastního zprostředkovatele členství za běhu. Třída předá userName a password metodě zprostředkovatele ValidateUser členství, ale nepředá customCredentialAuthenticationService . Pokud ValidateUser se vrátí true, AuthenticationService vytvoří ověřovací lístek jako soubor cookie. Nastavením parametru isPersistent na vytvořte true ověřovací lístek, který bude trvat déle než aktuální relace.

Poznámka

K ochraně citlivých dat vždy používejte ověřovací službu společně s vrstvou ssl (SSL, pomocí protokolu HTTPS).

Metoda Login vyvolá Authenticating událost a CreatingCookie událost. Vytvořte obslužnou rutinu události pro Authenticating , abyste mohli přizpůsobit ověřování, jako je kontrola hodnot v customCredential souboru nebo ověřování přihlašovacích údajů prostřednictvím jiného než výchozího zprostředkovatele členství. Výchozí zprostředkovatel členství neověřuje hodnoty v customCredential souboru . Pokud chcete přizpůsobit ověřovací soubor cookie, vytvořte obslužnou rutinu události pro CreatingCookie.

Poznámka

Nevolejte metodu Login z kódu, který se spouští na webovém serveru. Voláte metodu Login pouze jako součást služby WCF. Další informace najdete v tématu ověřování ASP.NET.

Viz také

• Přehled ověřovací služby Windows Communication Foundation