Bagikan melalui


WebProxy Kelas

Definisi

Berisi pengaturan proksi HTTP untuk HttpClient kelas .

public ref class WebProxy : System::Net::IWebProxy, System::Runtime::Serialization::ISerializable
public ref class WebProxy : System::Runtime::Serialization::ISerializable
public class WebProxy : System.Net.IWebProxy, System.Runtime.Serialization.ISerializable
[System.Serializable]
public class WebProxy : System.Net.IWebProxy, System.Runtime.Serialization.ISerializable
[System.Serializable]
public class WebProxy : System.Runtime.Serialization.ISerializable
type WebProxy = class
    interface IWebProxy
    interface ISerializable
[<System.Serializable>]
type WebProxy = class
    interface IWebProxy
    interface ISerializable
Public Class WebProxy
Implements ISerializable, IWebProxy
Public Class WebProxy
Implements ISerializable
Warisan
WebProxy
Atribut
Penerapan

Contoh

Contoh kode berikut menyiapkan HttpClient instans dengan WebProxy instans. HttpClient Instans menggunakan proksi untuk menyambungkan ke sumber daya Internet eksternal. (Misalnya yang menunjukkan penggunaan 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 komputer 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:

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 , BypassProxyOnLocal, dan BypassList yang diatur ke nilai yang digunakan oleh komputer lokal.

Metode mengembalikan Select instans WebProxy kelas dengan properti yang diatur sesuai dengan kombinasi pengaturan file Internet dan 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 berada, 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 URI, pengaturan 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 untuk dilewati.

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.
Kedaluwarsa.
Kedaluwarsa.

Membaca pengaturan proksi non-dinamik opsi Internet.

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 dari instans Type saat ini.

(Diperoleh dari Object)
IsBypassed(Uri)

Menunjukkan apakah akan menggunakan server proksi untuk host yang ditentukan.

MemberwiseClone()

Membuat salinan dangkal dari 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.

Berlaku untuk