HttpClient.DefaultProxy Properti

Definisi

Ruang nama:
System.Net.Http
Rakitan:
netstandard.dll, System.Net.Http.dll
Rakitan:
System.Net.Http.dll
Sumber:
HttpClient.cs
Sumber:
HttpClient.cs
Sumber:
HttpClient.cs
Sumber:
HttpClient.cs
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 di 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 inisialisasi DefaultProxy 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 pemrosesan melalui proxy. 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 terdepan) tidak akan cocok www.example.comdengan . Perilaku ini mungkin ditinjau kembali di masa depan untuk mencocokkan ekosistem lain dengan lebih baik.

Pada sistem di mana variabel lingkungan peka terhadap huruf besar dan kecil, nama variabel mungkin semua huruf kecil atau semua 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 berupa httpURL , , httpssocks4, socks4a, atau socks5 . URL tidak dapat menyertakan teks apa pun setelah nama host, IP, atau port. Jika skema tidak ditentukan, http diasumsikan. URL dapat secara opsional menyertakan nama pengguna dan kata sandi untuk autentikasi proksi, tetapi kata sandi diabaikan saat menggunakan socks4 atau socks4a karena protokol tidak memiliki dukungan untuk autentikasi kata sandi.

  • http: http://[username:password@]hostname[:port]
  • https: https://[username:password@]hostname[:port]
  • socks4: socks4://[username@]hostname[:port]
  • socks4a: socks4a://[username@]hostname[:port]
  • socks5: socks5://[username:password@]hostname[:port]

Berlaku untuk