WebClient.Credentials Properti

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.WebClient.dll

Sumber:

WebClient.cs

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; }

member this.Credentials : System.Net.ICredentials with get, set

Public Property Credentials As ICredentials

Nilai Properti

ICredentials

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.

Lihat juga

• NetworkCredential
• CredentialCache
• Credentials