WebClient.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.
Mendapatkan atau mengatur kredensial jaringan yang dikirim ke host dan digunakan untuk mengautentikasi permintaan.
public:
property System::Net::ICredentials ^ Credentials { System::Net::ICredentials ^ get(); void set(System::Net::ICredentials ^ value); };
public System.Net.ICredentials? Credentials { get; set; }
public System.Net.ICredentials Credentials { get; set; }
member this.Credentials : System.Net.ICredentials with get, set
Public Property Credentials As ICredentials
Nilai Properti
Yang ICredentials berisi kredensial autentikasi untuk permintaan tersebut. Default adalah null
.
Contoh
Contoh kode berikut menggunakan kredensial sistem pengguna untuk mengautentikasi permintaan.
int main()
{
try
{
WebClient^ client = gcnew WebClient;
client->Credentials = CredentialCache::DefaultCredentials;
array<Byte>^pageData = client->DownloadData( "http://www.contoso.com" );
String^ pageHtml = Encoding::ASCII->GetString( pageData );
Console::WriteLine( pageHtml );
}
catch ( WebException^ webEx )
{
Console::Write( webEx );
}
}
public static void Main()
{
try {
WebClient client = new WebClient();
client.Credentials = CredentialCache.DefaultCredentials;
Byte[] pageData = client.DownloadData("http://www.contoso.com");
string pageHtml = Encoding.ASCII.GetString(pageData);
Console.WriteLine(pageHtml);
} catch (WebException webEx) {
Console.Write(webEx.ToString());
}
}
Public Shared Sub Main()
Try
Dim client As New WebClient()
client.Credentials = CredentialCache.DefaultCredentials
Dim pageData As [Byte]() = client.DownloadData("http://www.contoso.com")
Dim pageHtml As String = Encoding.ASCII.GetString(pageData)
Console.WriteLine(pageHtml)
Catch webEx As WebException
Console.Write(webEx.ToString())
End Try
End Sub
Keterangan
Properti Credentials berisi kredensial autentikasi yang digunakan untuk mengakses sumber daya pada host. Dalam sebagian besar skenario sisi klien, Anda harus menggunakan DefaultCredentials, yang merupakan kredensial pengguna yang saat ini masuk. Untuk melakukan ini, atur properti ke UseDefaultCredentialstrue
alih-alih mengatur properti ini.
WebClient Jika kelas sedang digunakan dalam aplikasi tingkat menengah, seperti aplikasi ASP.NET, DefaultCredentials milik akun yang menjalankan halaman ASP (kredensial sisi server). Biasanya, Anda akan mengatur properti ini ke kredensial klien atas nama yang permintaannya dibuat.
Untuk alasan keamanan, saat mengikuti pengalihan secara otomatis, simpan kredensial yang ingin Anda sertakan dalam pengalihan dalam CredentialCache dan tetapkan ke properti ini. Properti ini akan secara otomatis diatur ke null
setelah pengalihan jika berisi apa pun kecuali CredentialCache. Memiliki nilai properti ini secara otomatis diatur ke null
dalam kondisi tersebut mencegah kredensial dikirim ke tujuan yang tidak diinginkan.
Berlaku untuk
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk