Bagikan melalui

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

  • Referensi

Definisi

Ruang nama:
System.Web.ApplicationServices
Rakitan:
System.Web.Extensions.dll

Memeriksa kredensial pengguna dan membuat tiket autentikasi (cookie) jika kredensial valid.

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

Nama pengguna yang akan divalidasi.

password
String

Kata sandi untuk pengguna yang ditentukan.

customCredential
String

Nilai atau nilai untuk divalidasi selain username dan password, jika ada.

isPersistent
Boolean

Nilai yang menunjukkan apakah tiket autentikasi tetap valid di seluruh sesi.

Mengembalikan

Boolean

true jika kredensial pengguna valid; jika tidak, false.

Atribut
OperationContractAttribute

Pengecualian

ArgumentNullException

userName atau password adalah null.

Keterangan

Metode ini Login memvalidasi kredensial pengguna melalui penyedia keanggotaan. Anda dapat menggunakan penyedia keanggotaan default atau menentukan penyedia keanggotaan kustom pada durasi. Kelas meneruskan userName dan password ke metode penyedia ValidateUser keanggotaan, tetapi tidak lulus customCredential.AuthenticationService Jika ValidateUser mengembalikan true, AuthenticationService membuat tiket autentikasi sebagai cookie. Atur isPersistent parameter ke true untuk membuat tiket autentikasi yang berlangsung di luar sesi saat ini.

Catatan

Selalu gunakan layanan autentikasi bersama dengan lapisan soket aman (SSL, dengan menggunakan HTTPS) untuk melindungi data sensitif.

Metode ini Login meningkatkan Authenticating peristiwa dan CreatingCookie peristiwa. Buat penanganan aktivitas untuk Authenticating menyesuaikan autentikasi, seperti memeriksa nilai di customCredential atau memvalidasi kredensial melalui penyedia keanggotaan non-default. Nilai di tidak divalidasi customCredential oleh penyedia keanggotaan default. Untuk menyesuaikan cookie autentikasi, buat penanganan aktivitas untuk CreatingCookie.

Catatan

Jangan panggil Login metode dari kode yang dijalankan pada server Web. Anda memanggil Login metode hanya sebagai bagian dari layanan WCF. Untuk informasi selengkapnya, lihat Autentikasi ASP.NET.

Berlaku untuk

Lihat juga