WebRequest.Credentials Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Saat ditimpa di kelas turunan, mendapatkan atau mengatur kredensial jaringan yang digunakan untuk mengautentikasi permintaan dengan sumber daya Internet.
public:
virtual property System::Net::ICredentials ^ Credentials { System::Net::ICredentials ^ get(); void set(System::Net::ICredentials ^ value); };public virtual System.Net.ICredentials Credentials { get; set; }public virtual System.Net.ICredentials? Credentials { get; set; }member this.Credentials : System.Net.ICredentials with get, setPublic Overridable Property Credentials As ICredentialsNilai Properti
Yang ICredentials berisi kredensial autentikasi yang terkait dengan permintaan. Defaultnya adalah null.
Pengecualian
Setiap upaya dilakukan untuk mendapatkan atau mengatur properti, ketika properti tidak ditimpa di kelas turunan.
Contoh
Contoh berikut mengatur Credentials properti menggunakan kredensial default pengguna saat ini. Ketika permintaan dibuat, kredensial yang disimpan di properti ini digunakan untuk memvalidasi klien. Ini identik dengan mengatur properti ke UseDefaultCredentialstrue.
// Create a request for the URL.
WebRequest request = WebRequest.Create ("http://www.contoso.com/default.html");
// If required by the server, set the credentials.
request.Credentials = CredentialCache.DefaultCredentials;
// Get the response.
HttpWebResponse response = (HttpWebResponse)request.GetResponse ();
' Create a request for the URL.
Dim request As WebRequest = WebRequest.Create("http://www.contoso.com/default.html")
' If required by the server, set the credentials.
request.Credentials = CredentialCache.DefaultCredentials
' Get the response.
Dim response As HttpWebResponse = CType(request.GetResponse(), HttpWebResponse)
Keterangan
Hati
WebRequest, , HttpWebRequestServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.
Properti Credentials berisi kredensial autentikasi yang diperlukan untuk mengakses sumber daya Internet.
Nota
Kelasnya WebRequest adalah kelas abstract . Perilaku WebRequest aktual instans pada run time ditentukan oleh kelas turunan yang dikembalikan oleh WebRequest.Create metode . Untuk informasi selengkapnya tentang nilai dan pengecualian default, lihat dokumentasi untuk kelas turunan, seperti HttpWebRequest dan FileWebRequest.
