HttpClient.DefaultProxy Proprietà

Definizione

Spazio dei nomi:
System.Net.Http
Assembly:
netstandard.dll, System.Net.Http.dll
Assembly:
System.Net.Http.dll
Origine:
HttpClient.cs
Origine:
HttpClient.cs
Origine:
HttpClient.cs
Origine:
HttpClient.cs
Origine:
HttpClient.cs

Ottiene o imposta il proxy HTTP globale.

public:
 static property System::Net::IWebProxy ^ DefaultProxy { System::Net::IWebProxy ^ get(); void set(System::Net::IWebProxy ^ value); };
public static System.Net.IWebProxy DefaultProxy { get; set; }
static member DefaultProxy : System.Net.IWebProxy with get, set
Public Shared Property DefaultProxy As IWebProxy

Valore della proprietà

IWebProxy

Proxy usato da ogni richiesta HTTP.

Eccezioni

ArgumentNullException

Il valore passato non può essere null.

Commenti

Questa proprietà statica determina il proxy predefinito usato da tutte le HttpClient istanze se non viene impostato alcun proxy in modo esplicito nel passato tramite il HttpMessageHandler relativo costruttore.

L'istanza predefinita restituita da questa proprietà inizializzerà in base a un set diverso di regole a seconda della piattaforma:

  • For Windows: legge la configurazione del proxy dalle variabili di ambiente o, se non sono definite, dalle impostazioni proxy dell'utente.

  • Per macOS: Legge la configurazione del proxy dalle variabili di ambiente o, se non definite, dalle impostazioni proxy del sistema.

  • Per Linux: Legge la configurazione proxy dalle variabili di ambiente o, nel caso in cui non siano definite, questa proprietà inizializza un'istanza non configurata che ignora tutti gli indirizzi.

Le variabili di ambiente utilizzate per l'inizializzazione di DefaultProxy sulle piattaforme basate su Windows e Unix sono:

  • HTTP_PROXY: il server proxy usato nelle richieste HTTP.
  • HTTPS_PROXY: il server proxy usato nelle richieste HTTPS.
  • ALL_PROXY: il server proxy usato nelle richieste HTTP e/o HTTPS nel caso in cui HTTP_PROXY e/o HTTPS_PROXY non siano definiti.
  • NO_PROXY: elenco delimitato da virgole di nomi host che devono essere esclusi dall'uso del proxy. Gli asterischi non sono supportati per i caratteri jolly; usare un punto iniziale nel caso in cui si voglia trovare una corrispondenza con un sottodominio. Esempi: NO_PROXY=.example.com (con punto iniziale) corrisponderà www.example.coma , ma non corrisponderà example.coma . NO_PROXY=example.com (senza punto iniziale) non corrisponderà www.example.coma . Questo comportamento potrebbe essere rivisitato in futuro per adattarsi meglio ad altri ecosistemi.

Nei sistemi in cui le variabili di ambiente fanno distinzione tra maiuscole e minuscole, i nomi delle variabili possono essere tutti minuscoli o maiuscoli. Per primi vengono controllati i nomi in minuscolo.

Il server proxy può essere un nome host o un indirizzo IP, seguito facoltativamente da due punti e da un numero di porta oppure può essere un httpURL , httpssocks4, socks4a, o socks5 . L'URL non può includere testo dopo il nome host, l'IP o la porta. Se non viene specificato uno schema, http si presuppone. L'URL può facoltativamente includere un nome utente e una password per l'autenticazione proxy, ma la password viene ignorata quando si usa socks4 o socks4a perché i protocolli non supportano l'autenticazione della password.

  • http: http://[username:password@]hostname[:port]
  • https: https://[username:password@]hostname[:port]
  • socks4: socks4://[username@]hostname[:port]
  • socks4a: socks4a://[username@]hostname[:port]
  • socks5: socks5://[username:password@]hostname[:port]

Si applica a