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 = gcnew WebProxy("http://proxyserver:80/", true);

// HttpClient lifecycle management best practices:
// https://zcusa.951200.xyz/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://zcusa.951200.xyz/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://zcusa.951200.xyz/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 utilisés HttpClient par les instances pour déterminer si un proxy web est utilisé pour envoyer des demandes. Les paramètres de proxy web globaux 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 réside dans la façon dont l’instance est initialisée avant qu’elle ne soit retournée à 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 , BypassProxyOnLocalet BypassList définies 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 Internet et de fichier de configuration.

La WebProxy classe prend en charge la détection et l’exécution automatiques de scripts de configuration de proxy. Cette fonctionnalité est également connue sous le nom de Découverte automatique de proxy Web (WPAD, Web Proxy Auto-Discovery). 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.

Constructeurs

Propriétés

Méthodes

Implémentations d’interfaces explicites

S’applique à