WebProxy WebProxy WebProxy WebProxy Class

Definición

Contiene la configuración del proxy HTTP para la clase WebRequest.Contains HTTP proxy settings for the WebRequest class.

public ref class WebProxy : System::Runtime::Serialization::ISerializable
[System.Serializable]
public class WebProxy : System.Runtime.Serialization.ISerializable
type WebProxy = class
    interface ISerializable
    interface IWebProxy
Public Class WebProxy
Implements ISerializable
Herencia
WebProxyWebProxyWebProxyWebProxy
Atributos
Implementaciones

Ejemplos

El siguiente código de ejemplo, se asigna un WebProxy instancia a un WebRequest instancia.The following code example assigns a WebProxy instance to a WebRequest instance. El WebRequest instancia utiliza el proxy para conectarse a recursos externos de Internet.The WebRequest instance uses the proxy to connect to external Internet resources. (Para obtener un ejemplo que muestra cómo utilizar la característica WPAD, consulte la documentación de la IWebProxyScript clase.)(For an example that demonstrates using the WPAD feature, see the documentation for the IWebProxyScript class.)

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

El WebProxy clase contiene la configuración de proxy que WebRequest las instancias se usan para determinar si se utiliza un proxy Web para enviar solicitudes.The WebProxy class contains the proxy settings that WebRequest instances use to determine whether a Web proxy is used to send requests. Configuración de proxy puede especificarse en el equipo y los archivos de configuración de aplicación y las aplicaciones Web de global puede usar instancias de la WebProxy clase para personalizar el uso del proxy Web.Global Web proxy settings can be specified in machine and application configuration files, and applications can use instances of the WebProxy class to customize Web proxy use. El WebProxy clase es la implementación base de la IWebProxy interfaz.The WebProxy class is the base implementation of the IWebProxy interface.

Para obtener instancias de la clase de proxy Web, puede usar cualquiera de los métodos siguientes:To obtain instances of the Web proxy class, you can use any of the following methods:

Estos métodos suministrar un WebProxy instancia que puede personalizar; la diferencia entre ellos es cómo se inicializa la instancia antes de devolverlos a la aplicación.These methods each supply a WebProxy instance that you can further customize; the difference between them is how the instance is initialized before it is returned to your application. El WebProxy constructor devuelve una instancia de la WebProxy clase con el Address propiedad establecida en null.The WebProxy constructor returns an instance of the WebProxy class with the Address property set to null. Cuando se usa una solicitud de un WebProxy instancia en este estado, no hay ningún proxy se usa para enviar la solicitud.When a request uses a WebProxy instance in this state, no proxy is used to send the request.

El GetDefaultProxy método devuelve una instancia de la WebProxy clase con el Address, BypassProxyOnLocal, y BypassList propiedades establecidas en los valores utilizados por Internet Explorer 5.5 y versiones posteriores.The GetDefaultProxy method returns an instance of the WebProxy class with the Address, BypassProxyOnLocal, and BypassList properties set to the values used by Internet Explorer 5.5 and later.

El Select método devuelve una instancia de la WebProxy clase con la las propiedades establecidas según una combinación de valores de archivo de configuración y de Internet Explorer.The Select method returns an instance of the WebProxy class with it properties set according to a combination of Internet Explorer and configuration file settings.

La WebProxy clase admite la detección automática y la ejecución de scripts de configuración de proxy.The WebProxy class supports automatic detection and execution of proxy configuration scripts. Esta característica también se conoce como detección automática de proxy web (WPAD).This feature is also known as Web Proxy Auto-Discovery (WPAD). Cuando se usa la configuración automática de proxy, un script de configuración, normalmente se denomina Wpad.dat, debe se encuentra, descargar, compilado y ejecutar.When using automatic proxy configuration, a configuration script, typically named Wpad.dat, must be located, downloaded, compiled, and run. Si estas operaciones se realizan correctamente, el script devuelve a los servidores proxy que pueden usarse para una solicitud.If these operations are successful, the script returns the proxies that can be used for a request.

Constructores

WebProxy() WebProxy() WebProxy() WebProxy()

Inicializa una instancia vacía de la clase WebProxy.Initializes an empty instance of the WebProxy class.

WebProxy(SerializationInfo, StreamingContext) WebProxy(SerializationInfo, StreamingContext) WebProxy(SerializationInfo, StreamingContext) WebProxy(SerializationInfo, StreamingContext)

Inicializa una instancia de la clase WebProxy utilizando el contenido previamente serializado.Initializes an instance of the WebProxy class using previously serialized content.

WebProxy(String) WebProxy(String) WebProxy(String) WebProxy(String)

Inicializa una nueva instancia de la clase WebProxy con el identificador URI especificado.Initializes a new instance of the WebProxy class with the specified URI.

WebProxy(String, Boolean) WebProxy(String, Boolean) WebProxy(String, Boolean) WebProxy(String, Boolean)

Inicializa una nueva instancia de la clase WebProxy con la dirección URI y el valor de omisión especificados.Initializes a new instance of the WebProxy class with the specified URI and bypass setting.

WebProxy(String, Boolean, String[]) WebProxy(String, Boolean, String[]) WebProxy(String, Boolean, String[]) 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.Initializes a new instance of the WebProxy class with the specified URI, bypass setting, and list of URIs to bypass.

WebProxy(String, Boolean, String[], ICredentials) WebProxy(String, Boolean, String[], ICredentials) WebProxy(String, Boolean, String[], ICredentials) 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.Initializes a new instance of the WebProxy class with the specified URI, bypass setting, list of URIs to bypass, and credentials.

WebProxy(String, Int32) WebProxy(String, Int32) WebProxy(String, Int32) WebProxy(String, Int32)

Inicializa una nueva instancia de la clase WebProxy con el host y número de puerto especificados.Initializes a new instance of the WebProxy class with the specified host and port number.

WebProxy(Uri) WebProxy(Uri) WebProxy(Uri) WebProxy(Uri)

Inicializa una instancia nueva de la clase WebProxy a partir de la instancia de Uri especificada.Initializes a new instance of the WebProxy class from the specified Uri instance.

WebProxy(Uri, Boolean) WebProxy(Uri, Boolean) WebProxy(Uri, Boolean) WebProxy(Uri, Boolean)

Inicializa una instancia nueva de la clase WebProxy con la instancia de Uri y el valor de omisión.Initializes a new instance of the WebProxy class with the Uri instance and bypass setting.

WebProxy(Uri, Boolean, String[]) WebProxy(Uri, Boolean, String[]) WebProxy(Uri, Boolean, String[]) 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.Initializes a new instance of the WebProxy class with the specified Uri instance, bypass setting, and list of URIs to bypass.

WebProxy(Uri, Boolean, String[], ICredentials) WebProxy(Uri, Boolean, String[], ICredentials) WebProxy(Uri, Boolean, String[], ICredentials) 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.Initializes a new instance of the WebProxy class with the specified Uri instance, bypass setting, list of URIs to bypass, and credentials.

Propiedades

Address Address Address Address

Obtiene o establece la dirección del servidor proxy.Gets or sets the address of the proxy server.

BypassArrayList BypassArrayList BypassArrayList BypassArrayList

Obtiene una lista de direcciones que no usan el servidor proxy.Gets a list of addresses that do not use the proxy server.

BypassList BypassList BypassList BypassList

Obtiene o establece una matriz de direcciones que no usan el servidor proxy.Gets or sets an array of addresses that do not use the proxy server.

BypassProxyOnLocal BypassProxyOnLocal BypassProxyOnLocal BypassProxyOnLocal

Obtiene o establece un valor que indica si se omitirá el servidor proxy para las direcciones locales.Gets or sets a value that indicates whether to bypass the proxy server for local addresses.

Credentials Credentials Credentials Credentials

Obtiene o establece las credenciales que se van a enviar al servidor proxy para la autenticación.Gets or sets the credentials to submit to the proxy server for authentication.

UseDefaultCredentials UseDefaultCredentials UseDefaultCredentials UseDefaultCredentials

Obtiene o establece un valor Boolean que controla si se envían DefaultCredentials con las solicitudes.Gets or sets a Boolean value that controls whether the DefaultCredentials are sent with requests.

Métodos

CreateDefaultProxy() CreateDefaultProxy() CreateDefaultProxy() CreateDefaultProxy()
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetDefaultProxy() GetDefaultProxy() GetDefaultProxy() GetDefaultProxy()

Lee la configuración proxy no dinámica de Internet Explorer.Reads the Internet Explorer nondynamic proxy settings.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext)

Llena SerializationInfo con los datos necesarios para serializar el objeto de destino.Populates a SerializationInfo with the data that is needed to serialize the target object.

GetProxy(Uri) GetProxy(Uri) GetProxy(Uri) GetProxy(Uri)

Devuelve el identificador URI del proxy para una solicitud.Returns the proxied URI for a request.

GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
IsBypassed(Uri) IsBypassed(Uri) IsBypassed(Uri) IsBypassed(Uri)

Indica si se va a usar el servidor proxy para el host especificado.Indicates whether to use the proxy server for the specified host.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Implementaciones de interfaz explícitas

ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Crea los datos y el contexto de la serialización utilizados por el sistema para serializar un objeto WebProxy.Creates the serialization data and context that are used by the system to serialize a WebProxy object.

Se aplica a