WebProxy Sınıf

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kod:

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

Açıklamalar

WebProxy sınıfı, örneklerin HttpClient istekleri göndermek için bir Web proxy'si kullanılıp kullanılmadığını belirlemek için kullandığı ara sunucu 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 temel uygulamasıdırIWebProxy.

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ı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 ara sunucu 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 ayarlanan özellikleriyle sınıfının bir örneğini döndürür.

sınıfı, WebProxy ara sunucu yapılandırma betiklerinin otomatik olarak algılanmasını 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, indirilmelidir, derlenmelidir ve çalıştırılmalıdır. Bu işlemler başarılı olursa betik, istek için kullanılabilecek proxy'leri döndürür.

Oluşturucular

WebProxy()	sınıfının boş bir örneğini WebProxy başlatır.
WebProxy(SerializationInfo, StreamingContext)	Geçersiz. Daha önce seri hale getirilmiş içeriği kullanarak sınıfının 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(String, Boolean)	Belirtilen URI ve atlama ayarıyla sınıfının yeni bir örneğini WebProxy başlatır.
WebProxy(String, Boolean, String[])	Belirtilen URI, atlama ayarı ve atlayacak URI'lerin listesiyle sınıfının yeni bir örneğini WebProxy başlatır.
WebProxy(String, Boolean, String[], ICredentials)	Belirtilen URI, atlama ayarı, atlayacak URI'lerin listesi ve kimlik bilgileri ile 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(Uri)	Belirtilen Uri örnekten WebProxy sınıfının yeni bir örneğini başlatır.
WebProxy(Uri, Boolean)	örnek ve atlama ayarıyla sınıfının yeni bir örneğini WebProxyUri başlatır.
WebProxy(Uri, Boolean, String[])	Sınıfın WebProxy yeni bir örneğini belirtilen Uri örnek, atlama ayarı ve atlayacak URI'ler listesiyle başlatır.
WebProxy(Uri, Boolean, String[], ICredentials)	Belirtilen Uri örnek, atlama ayarı, atlayacak URI'lerin listesi ve kimlik bilgileri ile sınıfının yeni bir örneğini WebProxy başlatır.

Özellikler

Address	Ara sunucunun adresini alır veya ayarlar.
BypassArrayList	Ara sunucuyu 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	İsteklerle gönderilip gönderilmediğini DefaultCredentials denetleen bir Boolean değer alır veya ayarlar.

Yöntemler

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)	bir istek için proksied URI'sini döndürür.
GetType()	Type Geçerli örneğini 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 Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Belirtik Arabirim Kullanımları

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Bir nesneyi seri hale getirmek için sistem tarafından kullanılan serileştirme WebProxy verilerini ve bağlamını oluşturur.