WebProxy Clase

Definición

Espacio de nombres:

System.Net

Ensamblado:

System.Net.WebProxy.dll

Source:

WebProxy.cs

Contiene la configuración del proxy HTTP para la clase HttpClient.

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

Herencia

Object

WebProxy

Implementaciones

IWebProxy ISerializable

Ejemplos

En el ejemplo de código siguiente se configura una HttpClient instancia con una WebProxy instancia de . La HttpClient instancia usa el proxy para conectarse a recursos externos de Internet. (Para obtener un ejemplo que muestra el uso de la característica WPAD, consulte la documentación de la IWebProxyScript clase ).

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

Comentarios

La WebProxy clase contiene la configuración de proxy que HttpClient usan las instancias para determinar si se usa un proxy web para enviar solicitudes. La configuración global del proxy web se puede especificar en los archivos de configuración de la máquina y de la aplicación, y las aplicaciones pueden usar instancias de la clase para personalizar el WebProxy uso del proxy web. La WebProxy clase es la implementación base de la IWebProxy interfaz .

Para obtener instancias de la clase proxy web, puede usar cualquiera de los métodos siguientes:

• El constructor WebProxy.

• El método GetDefaultProxy .

• El método Select .

Cada uno de estos métodos proporciona una WebProxy instancia que se puede personalizar aún más; la diferencia entre ellos es cómo se inicializa la instancia antes de que se devuelva a la aplicación. El WebProxy constructor devuelve una instancia de la WebProxy clase con la Address propiedad establecida en null. Cuando una solicitud usa una WebProxy instancia de en este estado, no se usa ningún proxy para enviar la solicitud.

El GetDefaultProxy método devuelve una instancia de la WebProxy clase con las Addresspropiedades , BypassProxyOnLocaly BypassList establecidas en los valores utilizados por el equipo local.

El Select método devuelve una instancia de la WebProxy clase con sus propiedades establecidas según una combinación de opciones de archivo de configuración e Internet.

La WebProxy clase admite la detección automática y la ejecución de scripts de configuración de proxy. Esta característica también se conoce como detección automática de proxy web (WPAD). Al usar la configuración de proxy automática, un script de configuración, normalmente denominado Wpad.dat, debe ubicarse, descargarse, compilarse y ejecutarse. Si estas operaciones se realizan correctamente, el script devuelve los servidores proxy que se pueden usar para una solicitud.

Constructores

WebProxy()	Inicializa una instancia vacía de la clase WebProxy.
WebProxy(SerializationInfo, StreamingContext)	Obsoletos. Inicializa una instancia de la clase WebProxy utilizando el contenido previamente serializado.
WebProxy(String)	Inicializa una nueva instancia de la clase WebProxy con el identificador URI especificado.
WebProxy(String, Boolean)	Inicializa una nueva instancia de la clase WebProxy con la dirección URI y el valor de omisión especificados.
WebProxy(String, Boolean, String[])	Inicializa una nueva instancia de la clase WebProxy con la dirección URI, el valor de omisión y la lista de direcciones URI que se deben omitir especificados.
WebProxy(String, Boolean, String[], ICredentials)	Inicializa una nueva instancia de la clase WebProxy con la dirección URI, el valor de omisión, la lista de direcciones URI que se deben omitir y las credenciales especificados.
WebProxy(String, Int32)	Inicializa una nueva instancia de la clase WebProxy con el host y número de puerto especificados.
WebProxy(Uri)	Inicializa una nueva instancia de la clase WebProxy a partir de la instancia de la clase Uri especificada.
WebProxy(Uri, Boolean)	Inicializa una instancia nueva de la clase WebProxy con la instancia de Uri y el valor de omisión.
WebProxy(Uri, Boolean, String[])	Inicializa una instancia nueva de la clase WebProxy con la instancia de Uri, el valor de omisión y la lista de direcciones URI que se deben omitir especificados.
WebProxy(Uri, Boolean, String[], ICredentials)	Inicializa una instancia nueva de la clase WebProxy con la instancia de Uri, el valor de omisión, la lista de direcciones URI que se deben omitir y las credenciales especificados.

Propiedades

Address	Obtiene o establece la dirección del servidor proxy.
BypassArrayList	Obtiene una lista de direcciones que no usan el servidor proxy.
BypassList	Obtiene o establece una matriz de direcciones que no usan el servidor proxy.
BypassProxyOnLocal	Obtiene o establece un valor que indica si debe omitirse el servidor proxy para las direcciones locales.
Credentials	Obtiene o establece las credenciales que se van a enviar al servidor proxy para la autenticación.
UseDefaultCredentials	Obtiene o establece un valor Boolean que controla si se envían DefaultCredentials con las solicitudes.

Métodos

Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetDefaultProxy()	Obsoletos. Lee la configuración de proxy no dinámico de opciones de Internet.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetObjectData(SerializationInfo, StreamingContext)	Llena SerializationInfo con los datos necesarios para serializar el objeto de destino.
GetProxy(Uri)	Devuelve el identificador URI del proxy para una solicitud.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
IsBypassed(Uri)	Indica si se va a usar el servidor proxy para el host especificado.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Implementaciones de interfaz explícitas

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Crea los datos y el contexto de la serialización utilizados por el sistema para serializar un objeto WebProxy.