WebProxy Classe

Définition

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

Public Class WebProxy
Implements ISerializable, IWebProxy

Public Class WebProxy
Implements ISerializable

Héritage

Object

WebProxy

Attributs

SerializableAttribute

Implémente

IWebProxy ISerializable

Exemples

L’exemple de code suivant configure une HttpClient instance avec une WebProxy instance. L’instance HttpClient utilise le proxy pour se connecter à des ressources Internet externes. (Pour obtenir un exemple illustrant l’utilisation de la fonctionnalité WPAD, consultez la documentation de la IWebProxyScript classe.)

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

Remarques

La WebProxy classe contient les paramètres de proxy que HttpClient les instances utilisent pour déterminer si un proxy Web est utilisé pour envoyer des requêtes. Les paramètres globaux du proxy web peuvent être spécifiés dans les fichiers de configuration de l’ordinateur et de l’application, et les applications peuvent utiliser des instances de la classe pour personnaliser l’utilisation WebProxy du proxy web. La WebProxy classe est l’implémentation de base de l’interface IWebProxy .

Pour obtenir des instances de la classe proxy Web, vous pouvez utiliser l’une des méthodes suivantes :

• Constructeur WebProxy .
• Méthode GetDefaultProxy.
• Méthode Select.

Ces méthodes fournissent chacune une WebProxy instance que vous pouvez personnaliser davantage ; la différence entre elles est la façon dont l’instance est initialisée avant son retour à votre application. Le WebProxy constructeur retourne une instance de la WebProxy classe avec la Address propriété définie sur null. Lorsqu’une requête utilise une WebProxy instance dans cet état, aucun proxy n’est utilisé pour envoyer la requête.

La GetDefaultProxy méthode retourne une instance de la WebProxy classe avec les Addresspropriétés définies BypassProxyOnLocalBypassList sur les valeurs utilisées par l’ordinateur local.

La Select méthode retourne une instance de la WebProxy classe avec ses propriétés définies en fonction d’une combinaison de paramètres de fichier de configuration et Internet.

La WebProxy classe prend en charge la détection et l’exécution automatiques des scripts de configuration de proxy. Cette fonctionnalité est également connue sous le nom de découverte automatique du proxy web (WPAD). Lors de l’utilisation de la configuration automatique du proxy, un script de configuration, généralement nommé Wpad.dat, doit être localisé, téléchargé, compilé et exécuté. Si ces opérations réussissent, le script retourne les proxys qui peuvent être utilisés pour une demande.