WebProxy Kelas

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.WebProxy.dll

Sumber:

WebProxy.cs

Berisi pengaturan proksi HTTP untuk HttpClient kelas .

public ref class WebProxy : System::Net::IWebProxy, System::Runtime::Serialization::ISerializable

public class WebProxy : System.Net.IWebProxy, System.Runtime.Serialization.ISerializable

type WebProxy = class
    interface IWebProxy
    interface ISerializable

Public Class WebProxy
Implements ISerializable, IWebProxy

Warisan

Object

WebProxy

Penerapan

IWebProxy ISerializable

Contoh

Contoh kode berikut menyiapkan HttpClient instans dengan WebProxy instans. Instans HttpClient menggunakan proksi untuk menyambungkan ke sumber daya Internet eksternal. (Misalnya yang menunjukkan menggunakan fitur WPAD, lihat dokumentasi untuk IWebProxyScript kelas .)

WebProxy^ proxyObject = gcnew WebProxy("http://proxyserver:80/", true);

// HttpClient lifecycle management best practices:
// https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
HttpClientHandler^ handler = gcnew HttpClientHandler();
handler->Proxy = proxyObject;
HttpClient^ client = gcnew HttpClient(handler);

WebProxy proxyObject = new WebProxy("http://proxyserver:80/", true);

// HttpClient lifecycle management best practices:
// https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
HttpClient client = new HttpClient(new HttpClientHandler
{
    Proxy = proxyObject
});

Dim proxyObject As New WebProxy("http://proxyserver:80/", True)

' HttpClient lifecycle management best practices:
' https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
Dim client As New HttpClient(New HttpClientHandler With
{
    .Proxy = proxyObject
})

Keterangan

Kelas WebProxy berisi pengaturan proksi yang HttpClient digunakan instans untuk menentukan apakah proksi Web digunakan untuk mengirim permintaan. Pengaturan proksi Web Global dapat ditentukan dalam file konfigurasi mesin dan aplikasi, dan aplikasi dapat menggunakan instans WebProxy kelas untuk menyesuaikan penggunaan proksi Web. Kelas WebProxy adalah implementasi IWebProxy dasar antarmuka.

Untuk mendapatkan instans kelas proksi Web, Anda dapat menggunakan salah satu metode berikut:

• Konstruktor WebProxy .

• Metode GetDefaultProxy.

• Metode Select.

Metode ini masing-masing menyediakan WebProxy instans yang dapat Anda sesuaikan lebih lanjut; perbedaan di antara mereka adalah bagaimana instans diinisialisasi sebelum dikembalikan ke aplikasi Anda. WebProxy Konstruktor mengembalikan instans WebProxy kelas dengan properti diatur Address ke null. Ketika permintaan menggunakan instans WebProxy dalam status ini, tidak ada proksi yang digunakan untuk mengirim permintaan.

Metode mengembalikan GetDefaultProxy instans WebProxy kelas dengan Addressproperti , , BypassProxyOnLocaldan BypassList yang diatur ke nilai yang digunakan oleh Internet Explorer 5.5 dan yang lebih baru.

Metode mengembalikan Select instans WebProxy kelas dengan properti yang diatur sesuai dengan kombinasi Internet Explorer dan pengaturan file konfigurasi.

Kelas ini WebProxy mendukung deteksi otomatis dan eksekusi skrip konfigurasi proksi. Fitur ini juga dikenal sebagai Web Proxy Auto-Discovery (WPAD). Saat menggunakan konfigurasi proksi otomatis, skrip konfigurasi, biasanya bernama Wpad.dat, harus ditemukan, diunduh, dikompilasi, dan dijalankan. Jika operasi ini berhasil, skrip mengembalikan proksi yang dapat digunakan untuk permintaan.

Konstruktor

WebProxy()	Menginisialisasi instans WebProxy kosong kelas.
WebProxy(SerializationInfo, StreamingContext)	Kedaluwarsa. Menginisialisasi instans WebProxy kelas menggunakan konten yang diserialisasikan sebelumnya.
WebProxy(String)	Menginisialisasi instans WebProxy baru kelas dengan URI yang ditentukan.
WebProxy(String, Boolean)	Menginisialisasi instans WebProxy baru kelas dengan pengaturan URI dan bypass yang ditentukan.
WebProxy(String, Boolean, String[])	Menginisialisasi instans WebProxy baru kelas dengan URI, pengaturan bypass, dan daftar URI yang ditentukan untuk dilewati.
WebProxy(String, Boolean, String[], ICredentials)	Menginisialisasi instans WebProxy baru kelas dengan pengaturan URI, bypass, daftar URI yang ditentukan untuk dilewati, dan kredensial.
WebProxy(String, Int32)	Menginisialisasi instans WebProxy baru kelas dengan host dan nomor port yang ditentukan.
WebProxy(Uri)	Menginisialisasi instans WebProxy baru kelas dari instans yang ditentukan Uri .
WebProxy(Uri, Boolean)	Menginisialisasi instans WebProxy baru kelas dengan Uri pengaturan instans dan bypass.
WebProxy(Uri, Boolean, String[])	Menginisialisasi instans WebProxy baru kelas dengan instans yang ditentukan Uri , pengaturan bypass, dan daftar URI ke bypass.
WebProxy(Uri, Boolean, String[], ICredentials)	Menginisialisasi instans WebProxy baru kelas dengan instans yang ditentukan Uri , pengaturan bypass, daftar URI ke bypass, dan kredensial.

Properti

Address	Mendapatkan atau mengatur alamat server proksi.
BypassArrayList	Mendapatkan daftar alamat yang tidak menggunakan server proksi.
BypassList	Mendapatkan atau mengatur array alamat yang tidak menggunakan server proksi.
BypassProxyOnLocal	Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan melewati server proksi untuk alamat lokal.
Credentials	Mendapatkan atau mengatur kredensial untuk dikirimkan ke server proksi untuk autentikasi.
UseDefaultCredentials	Mendapatkan atau menetapkan Boolean nilai yang mengontrol apakah DefaultCredentials dikirim dengan permintaan.

Metode

Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetDefaultProxy()	Kedaluwarsa. Membaca pengaturan proksi nondinamis Internet Explorer.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetObjectData(SerializationInfo, StreamingContext)	Mengisi SerializationInfo dengan data yang diperlukan untuk menserialisasikan objek target.
GetProxy(Uri)	Mengembalikan URI yang diproksi untuk permintaan.
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
IsBypassed(Uri)	Menunjukkan apakah akan menggunakan server proksi untuk host yang ditentukan.
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Implementasi Antarmuka Eksplisit

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Membuat data dan konteks serialisasi yang digunakan oleh sistem untuk membuat WebProxy serialisasi objek.