HttpClient.DefaultProxy Properti

Definisi

Ruang nama:

System.Net.Http

Rakitan:

System.Net.Http.dll

Sumber:

HttpClient.cs

Mendapatkan atau mengatur proksi HTTP global.

public:
 static property System::Net::IWebProxy ^ DefaultProxy { System::Net::IWebProxy ^ get(); void set(System::Net::IWebProxy ^ value); };

public static System.Net.IWebProxy DefaultProxy { get; set; }

static member DefaultProxy : System.Net.IWebProxy with get, set

Public Shared Property DefaultProxy As IWebProxy

Nilai Properti

IWebProxy

Proksi yang digunakan oleh setiap permintaan HTTP.

Pengecualian

ArgumentNullException

Nilai yang diteruskan tidak boleh null.

Keterangan

Properti statis ini menentukan proksi default yang digunakan semua HttpClient instans jika tidak ada proksi yang diatur secara eksplisit dalam yang diteruskan HttpMessageHandler melalui konstruktornya.

Instans default yang dikembalikan oleh properti ini akan menginisialisasi mengikuti serangkaian aturan yang berbeda tergantung pada platform Anda:

• Untuk Windows: Membaca konfigurasi proksi dari variabel lingkungan atau, jika tidak ditentukan, dari pengaturan proksi pengguna.

• Untuk macOS: Membaca konfigurasi proksi dari variabel lingkungan atau, jika tidak ditentukan, dari pengaturan proksi sistem.

• Untuk Linux: Membaca konfigurasi proksi dari variabel lingkungan atau, jika tidak ditentukan, properti ini menginisialisasi instans yang tidak dikonfigurasi yang melewati semua alamat.

Variabel lingkungan yang digunakan untuk DefaultProxy inisialisasi pada platform berbasis Windows dan Unix adalah:

• HTTP_PROXY: server proksi yang digunakan pada permintaan HTTP.
• HTTPS_PROXY: server proksi yang digunakan pada permintaan HTTPS.
• ALL_PROXY: server proksi yang digunakan pada permintaan HTTP dan/atau HTTPS jika HTTP_PROXY dan/atau HTTPS_PROXY tidak ditentukan.
• NO_PROXY: daftar nama host yang dipisahkan koma yang harus dikecualikan dari proksi. Tanda bintang tidak didukung untuk kartubebas; gunakan titik di depan jika Anda ingin mencocokkan subdomain. Contoh: NO_PROXY=.example.com (dengan titik terdepan) akan cocok www.example.com, tetapi tidak akan cocok example.comdengan . NO_PROXY=example.com (tanpa titik di depan) tidak akan cocok www.example.com. Perilaku ini mungkin ditinjau kembali di masa depan untuk mencocokkan ekosistem lain dengan lebih baik.

Pada sistem di mana variabel lingkungan peka huruf besar/kecil, nama variabel bisa semua huruf kecil atau huruf besar. Nama-nama huruf kecil diperiksa terlebih dahulu.

Server proksi mungkin berupa nama host atau alamat IP, secara opsional diikuti oleh titik dua dan nomor port, atau mungkin URL http, secara opsional termasuk nama pengguna dan kata sandi untuk autentikasi proksi. URL harus dimulai dengan http, bukan https, dan tidak dapat menyertakan teks apa pun setelah nama host, IP, atau port.