WebClient.Credentials Properti

Referensi

Definisi

Ruang nama:: System.Net

Rakitan:: System.Net.WebClient.dll

Rakitan:: System.dll

Rakitan:: netstandard.dll

Sumber:: WebClient.cs

Sumber:: WebClient.cs

Sumber:: WebClient.cs

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

ICredentials

ICredentials yang berisi kredensial autentikasi untuk permintaan tersebut. Defaultnya 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

Hati

WebRequest, HttpWebRequest, ServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

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 UseDefaultCredentials ke true alih-alih mengatur properti ini.

Jika kelas WebClient 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 permintaan 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

Bagikan melalui