WebProxy Clase

Definición

Espacio de nombres:

System.Net

Ensamblado:

System.Net.WebProxy.dll

Ensamblado:

System.dll

Ensamblado:

netstandard.dll

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

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

[<System.Serializable>]
type WebProxy = class
    interface ISerializable
    interface IWebProxy

Public Class WebProxy
Implements ISerializable, IWebProxy

Public Class WebProxy
Implements ISerializable

Herencia

Object

WebProxy

Atributos

SerializableAttribute

Implementaciones

IWebProxy ISerializable

Ejemplos

En el ejemplo de código siguiente se asigna una WebProxy instancia a una WebRequest instancia de . La WebRequest 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 );
WebRequest^ req = WebRequest::Create( "http://www.contoso.com" );
req->Proxy = proxyObject;

WebProxy proxyObject = new WebProxy("http://proxyserver:80/",true);
WebRequest req = WebRequest.Create("http://www.contoso.com");
req.Proxy = proxyObject;

Dim proxyObject As New WebProxy("http://proxyserver:80/", True)
Dim req As WebRequest = WebRequest.Create("http://www.contoso.com")
req.Proxy = proxyObject

Comentarios

La WebProxy clase contiene la configuración de proxy que WebRequest 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 WebProxy clase para personalizar el 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:

• 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 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 usados por Internet Explorer 5.5 y versiones posteriores.

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

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). Cuando se usa la configuración automática del proxy, un script de configuración, normalmente denominado Wpad.dat, debe encontrarse, 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)	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

CreateDefaultProxy()
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetDefaultProxy()	Obsoleto. Obsoleto. Obsoleto. Lee la configuración proxy no dinámica de Internet Explorer.
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.