WebProxy Sınıf

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Net.WebProxy.dll

Kaynak:

WebProxy.cs

Sınıfın HttpClient HTTP proxy ayarlarını içerir.

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

Devralma

Object

WebProxy

Uygulamalar

IWebProxy ISerializable

Örnekler

Aşağıdaki kod örneği, örneği olan bir HttpClientWebProxy örneği ayarlar. Örnek, HttpClient dış İnternet kaynaklarına bağlanmak için ara sunucuyu kullanır. (WPAD özelliğini kullanmayı gösteren bir örnek için sınıfın belgelerine IWebProxyScript bakın.)

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
})

Açıklamalar

sınıfı, WebProxy bir Web proxy'sinin HttpClient istek göndermek için kullanılıp kullanılmadığını belirlemek için örneklerin kullandığı proxy ayarlarını içerir. Genel Web proxy ayarları makine ve uygulama yapılandırma dosyalarında belirtilebilir ve uygulamalar Web proxy kullanımını özelleştirmek için sınıfın WebProxy örneklerini kullanabilir. WebProxy sınıfı, arabiriminin IWebProxy temel uygulamasıdır.

Web proxy sınıfının örneklerini almak için aşağıdaki yöntemlerden herhangi birini kullanabilirsiniz:

• WebProxy Oluşturucu.
• GetDefaultProxy yöntemi.
• Select yöntemi.

Bu yöntemlerin her biri daha fazla özelleştirebileceğiniz bir WebProxy örnek sağlar; aralarındaki fark, örneğin uygulamanıza döndürülmeden önce nasıl başlatıldığıdır. Oluşturucu, WebProxy özelliğinin WebProxy olarak ayarlandığı sınıfın Address bir örneğini nulldöndürür. bir istek bu durumdaki bir WebProxy örneği kullandığında, isteği göndermek için hiçbir proxy kullanılmaz.

GetDefaultProxy yöntemi, , BypassProxyOnLocalve BypassList özellikleri yerel bilgisayar tarafından kullanılan değerlere ayarlanmış sınıfın Addressbir örneğini WebProxy döndürür.

yöntemi, Select internet ve yapılandırma dosyası ayarlarının WebProxy bir bileşimine göre ayarlanmış özelliklere sahip sınıfın bir örneğini döndürür.

sınıfı, WebProxy ara sunucu yapılandırma betiklerinin otomatik olarak algılanması ve yürütülmesini destekler. Bu özellik, Web Proxy Otomatik Bulma (WPAD) olarak da bilinir. Otomatik ara sunucu yapılandırması kullanılırken, genellikle Wpad.dat adlı bir yapılandırma betiği bulunmalıdır, indirilmeli, derlenmelidir ve çalıştırılmalıdır. Bu işlemler başarılı olursa, betik bir istek için kullanılabilecek proxy'leri döndürür.

Oluşturucular

Name	Description
WebProxy()	sınıfının boş bir örneğini WebProxy başlatır.
WebProxy(SerializationInfo, StreamingContext)	Geçersiz. Daha önce serileştirilmiş içeriği kullanarak sınıfının bir örneğini WebProxy başlatır.
WebProxy(String, Boolean, String[], ICredentials)	Belirtilen URI, atlama ayarı, atlayacak URI'lerin listesi ve kimlik bilgileriyle sınıfın yeni bir örneğini WebProxy başlatır.
WebProxy(String, Boolean, String[])	Belirtilen URI, atlama ayarı ve atlayacak URI'lerin listesi ile sınıfın yeni bir örneğini WebProxy başlatır.
WebProxy(String, Boolean)	Belirtilen URI ve atlama ayarıyla sınıfının yeni bir örneğini WebProxy başlatır.
WebProxy(String, Int32)	Belirtilen konak ve bağlantı noktası numarasıyla sınıfının yeni bir örneğini WebProxy başlatır.
WebProxy(String)	Belirtilen URI ile sınıfının yeni bir örneğini WebProxy başlatır.
WebProxy(Uri, Boolean, String[], ICredentials)	Sınıfın WebProxy yeni bir örneğini belirtilen Uri örnekle, atlama ayarıyla, atlayacak URI'lerin listesiyle ve kimlik bilgileriyle başlatır.
WebProxy(Uri, Boolean, String[])	Sınıfın WebProxy yeni bir örneğini belirtilen Uri örnekle, atlama ayarıyla ve atlayacak URI'lerin listesiyle başlatır.
WebProxy(Uri, Boolean)	örneği ve atlama ayarıyla sınıfının yeni bir örneğini WebProxyUri başlatır.
WebProxy(Uri)	Belirtilen Uri örnekten WebProxy sınıfının yeni bir örneğini başlatır.

Özellikler

Name	Description
Address	Ara sunucunun adresini alır veya ayarlar.
BypassArrayList	Proxy sunucusunu kullanmayan adreslerin listesini alır.
BypassList	Ara sunucuyu kullanmayan bir adres dizisini alır veya ayarlar.
BypassProxyOnLocal	Yerel adresler için ara sunucunun atlanıp atlanmayacağını belirten bir değer alır veya ayarlar.
Credentials	Kimlik doğrulaması için ara sunucuya göndermek üzere kimlik bilgilerini alır veya ayarlar.
UseDefaultCredentials	öğesinin isteklerle gönderilip gönderilmediğini DefaultCredentials denetleyebilen bir Boolean değer alır veya ayarlar.

Yöntemler

Name	Description
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetDefaultProxy()	Geçersiz. İnternet seçenekleri dinamik olmayan ara sunucu ayarlarını okur.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetObjectData(SerializationInfo, StreamingContext)	hedef nesneyi seri hale getirmek için gereken verilerle doldurur SerializationInfo .
GetProxy(Uri)	İstek için proksid URI'sini döndürür.
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
IsBypassed(Uri)	Belirtilen konak için ara sunucunun kullanılıp kullanılmayacağını gösterir.
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)

Belirtik Arabirim Kullanımları

Name	Description
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Bir nesneyi serileştirmek için sistem tarafından kullanılan serileştirme WebProxy verilerini ve bağlamını oluşturur.