HttpClient.DefaultProxy Proprietà

Definizione

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à

Proxy usato da ogni richiesta HTTP.

Eccezioni

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 HttpMessageHandler costruttore passato.

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

  • Per 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 sono definite, dalle impostazioni proxy del sistema.

  • Per Linux: Legge la configurazione del 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 usate per DefaultProxy l'inizializzazione nelle 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 HTTP_PROXY e/o HTTPS_PROXY non siano definiti.
  • NO_PROXY: elenco delimitato da virgole di nomi host che devono essere esclusi dal 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 in modo da corrispondere 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. I nomi minuscoli vengono controllati per primi.

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 URL HTTP, incluso facoltativamente un nome utente e una password per l'autenticazione proxy. L'URL deve iniziare con http, non httpse non può includere testo dopo il nome host, l'IP o la porta.

Si applica a