WebProxy WebProxy WebProxy WebProxy Class

Définition

Contient les paramètres du proxy HTTP pour la classe 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
Héritage
WebProxyWebProxyWebProxyWebProxy
Attributs
Implémente

Exemples

Le code suivant exemple assigne un WebProxy l’instance à un WebRequest instance.The following code example assigns a WebProxy instance to a WebRequest instance. Le WebRequest instance utilise le proxy pour se connecter à des ressources Internet externes.The WebRequest instance uses the proxy to connect to external Internet resources. (Pour obtenir un exemple illustrant l’utilisation de la fonctionnalité WPAD, consultez la documentation relative à la IWebProxyScript classe.)(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

Remarques

Le WebProxy classe contient les paramètres de proxy qui WebRequest instances permet de déterminer si un proxy Web est utilisé pour envoyer des demandes.The WebProxy class contains the proxy settings that WebRequest instances use to determine whether a Web proxy is used to send requests. Web globale des paramètres de proxy peuvent être spécifiés dans la machine et les fichiers de configuration d’application et les applications permettre utiliser des instances de la WebProxy classe pour personnaliser l’utilisation du 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. Le WebProxy classe est l’implémentation de base de la IWebProxy interface.The WebProxy class is the base implementation of the IWebProxy interface.

Pour obtenir des instances de la classe de proxy Web, vous pouvez utiliser une des méthodes suivantes :To obtain instances of the Web proxy class, you can use any of the following methods:

Ces méthodes fournissent chacune un WebProxy personnaliser de l’instance que vous pouvez aussi effectuer ; la différence entre les deux est la façon dont l’instance est initialisée avant d’être retournée à votre application.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. Le WebProxy constructeur retourne une instance de la WebProxy classe avec le Address propriété définie sur null.The WebProxy constructor returns an instance of the WebProxy class with the Address property set to null. Lorsqu’une demande utilise un WebProxy instance dans cet état, aucun proxy n’est utilisée pour envoyer la demande.When a request uses a WebProxy instance in this state, no proxy is used to send the request.

Le GetDefaultProxy méthode retourne une instance de la WebProxy classe avec le Address, BypassProxyOnLocal, et BypassList propriétés définies pour les valeurs utilisées par Internet Explorer 5.5 et versions ultérieures.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.

Le Select méthode retourne une instance de la WebProxy classe sert-il propriétés définies selon une combinaison de paramètres de fichier de configuration et 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.

Le WebProxy classe prend en charge la détection automatique et l’exécution de scripts de configuration de proxy.The WebProxy class supports automatic detection and execution of proxy configuration scripts. Cette fonctionnalité est également connue sous le nom de Découverte automatique de proxy Web (WPAD, Web Proxy Auto-Discovery).This feature is also known as Web Proxy Auto-Discovery (WPAD). Lorsque vous utilisez la configuration automatique du proxy, un script de configuration, généralement nommé Wpad.dat, doit être situé, téléchargé, compilé et exécuté.When using automatic proxy configuration, a configuration script, typically named Wpad.dat, must be located, downloaded, compiled, and run. Si ces opérations réussissent, le script retourne les proxys qui peuvent être utilisées pour une demande.If these operations are successful, the script returns the proxies that can be used for a request.

Constructeurs

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

Initialise une instance vide de la classe WebProxy.Initializes an empty instance of the WebProxy class.

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

Initialise une instance de la classe WebProxy avec du contenu précédemment sérialisé.Initializes an instance of the WebProxy class using previously serialized content.

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

Initialise une nouvelle instance de la classe WebProxy avec l'URI spécifié.Initializes a new instance of the WebProxy class with the specified URI.

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

Initialise une nouvelle instance de la classe WebProxy avec l’URI et le paramètre d’exception spécifiés.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[])

Initialise une nouvelle instance de la classe WebProxy avec l’URI, le paramètre d’exception et la liste des URI à ignorer spécifiés.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)

Initialise une nouvelle instance de la classe WebProxy avec l’URI, le paramètre d’exception, la liste des URI à ignorer et les informations d’identification spécifiés.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)

Initialise une nouvelle instance de la classe WebProxy avec l’hôte et le numéro de port spécifiés.Initializes a new instance of the WebProxy class with the specified host and port number.

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

Initialise une nouvelle instance de la classe WebProxy à partir de l'instance de Uri spécifiée.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)

Initialise une nouvelle instance de la classe WebProxy avec l’instance de Uri et le paramètre d’exception.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[])

Initialise une nouvelle instance de la classe WebProxy avec l’instance de Uri, le paramètre d’exception et la liste des URI à ignorer spécifiés.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)

Initialise une nouvelle instance de la classe WebProxy avec l’instance de Uri, le paramètre d’exception, la liste des URI à ignorer et les informations d’identification spécifiés.Initializes a new instance of the WebProxy class with the specified Uri instance, bypass setting, list of URIs to bypass, and credentials.

Propriétés

Address Address Address Address

Obtient ou définit l’adresse du serveur proxy.Gets or sets the address of the proxy server.

BypassArrayList BypassArrayList BypassArrayList BypassArrayList

Obtient une liste d’adresses qui n’utilisent pas le serveur proxy.Gets a list of addresses that do not use the proxy server.

BypassList BypassList BypassList BypassList

Obtient ou définit un tableau d’adresses qui n’utilisent pas le serveur proxy.Gets or sets an array of addresses that do not use the proxy server.

BypassProxyOnLocal BypassProxyOnLocal BypassProxyOnLocal BypassProxyOnLocal

Obtient ou définit une valeur qui indique si le serveur proxy doit être contourné pour les adresses locales.Gets or sets a value that indicates whether to bypass the proxy server for local addresses.

Credentials Credentials Credentials Credentials

Obtient ou définit les informations d’identification à envoyer au serveur proxy pour l’authentification.Gets or sets the credentials to submit to the proxy server for authentication.

UseDefaultCredentials UseDefaultCredentials UseDefaultCredentials UseDefaultCredentials

Obtient ou définit une valeur Boolean qui contrôle si les DefaultCredentials sont envoyés avec les demandes.Gets or sets a Boolean value that controls whether the DefaultCredentials are sent with requests.

Méthodes

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

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

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

Lit les paramètres du proxy non dynamiques d’Internet Explorer.Reads the Internet Explorer nondynamic proxy settings.

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

Fait office de fonction de hachage par défaut.Serves as the default hash function.

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

Remplit SerializationInfo avec les données qui sont nécessaires pour sérialiser l'objet cible.Populates a SerializationInfo with the data that is needed to serialize the target object.

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

Retourne l’URI proxy d’une demande.Returns the proxied URI for a request.

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

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

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

Indique si le serveur proxy doit être utilisé pour l’hôte spécifié.Indicates whether to use the proxy server for the specified host.

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

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

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

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)

Implémentations d’interfaces explicites

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

Crée les données de sérialisation et le contexte qui sont utilisés par le système pour sérialiser un objet WebProxy.Creates the serialization data and context that are used by the system to serialize a WebProxy object.

S’applique à