HttpClient.DefaultProxy Proprietà

Definizione

Spazio dei nomi:

System.Net.Http

Assembly:

System.Net.Http.dll

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 in modo esplicito nel HttpMessageHandler relativo costruttore.

L'istanza predefinita restituita da questa proprietà inizializzerà 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 in cui 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 desidera corrispondere a un sottodominio. Esempi: NO_PROXY=.example.com (con punto iniziale) corrisponderà www.example.com, 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 corrispondere ad altri ecosistemi migliori.

Nei sistemi in cui le variabili di ambiente sono distinzione tra maiuscole e minuscole, i nomi delle variabili possono essere tutti minuscoli o tutti maiuscoli. I nomi minuscoli vengono controllati prima.

Il server proxy può essere un nome host o un indirizzo IP, facoltativamente seguito da due punti e un numero di porta oppure può essere un URL http, facoltativamente incluso un nome utente e una password per l'autenticazione proxy. L'URL deve essere avviato con http, non e non httpspuò includere alcun testo dopo il nome host, l'IP o la porta.