<defaultProxy> , element (ustawienia sieciowe)
Konfiguruje serwer proxy protokołu HTTP (Hypertext Transfer Protocol).
<konfiguracja><system.net<>defaultProxy>
Uwaga
Jeśli przeprowadzasz migrację do platformy .NET 6 lub nowszej, skonfiguruj serwer proxy przy użyciu HttpClient.DefaultProxy właściwości .
Składnia
<defaultProxy
enabled="True|False"
useDefaultCredentials="True|False">
<bypasslist>...</bypasslist>
<proxy>...</proxy>
<module>...</module>
</defaultProxy>
Atrybuty i elementy
W poniższych sekcjach opisano atrybuty, elementy podrzędne i elementy nadrzędne.
Atrybuty
Element | Opis |
---|---|
enabled |
Określa, czy jest używany internetowy serwer proxy. Wartość domyślna to True . |
useDefaultCredentials |
Określa, czy domyślne poświadczenia dla tego hosta są używane do uzyskiwania dostępu do internetowego serwera proxy. Wartość domyślna to False . |
Elementy podrzędne
Element | Opis |
---|---|
Bypasslist | Zawiera zestaw wyrażeń regularnych opisujących adresy, które nie używają serwera proxy. |
module | Dodaje nowy moduł proxy do aplikacji. |
Serwera proxy | Definiuje serwer proxy. |
Elementy nadrzędne
Element | Opis |
---|---|
system.net | Zawiera ustawienia określające sposób łączenia programu .NET Framework z siecią. |
Uwagi
defaultProxy
Jeśli element jest pusty, używane są ustawienia serwera proxy systemu.
Wyjątek jest zgłaszany, jeśli element modułu określa typ inny niż publiczny, typ nie pochodzi z IWebProxy klasy, wyjątek od konstruktora bez parametrów tego obiektu wystąpił lub wystąpił wyjątek podczas pobierania domyślnego serwera proxy określonego przez system. Właściwość InnerException wyjątku powinna zawierać więcej informacji na temat głównej przyczyny błędu.
Pliki konfiguracji
Tego elementu można użyć w pliku konfiguracji aplikacji lub pliku konfiguracji maszyny (Machine.config).
Przykład
Poniższy przykład używa wartości domyślnych z serwera proxy systemu, określa adres serwera proxy i pomija serwer proxy dla dostępu lokalnego i contoso.com.
<configuration>
<system.net>
<defaultProxy>
<proxy
usesystemdefault="True"
proxyaddress="http://192.168.1.10:3128"
bypassonlocal="True"
/>
<bypasslist>
<add address="[a-z]+\.contoso\.com$" />
</bypasslist>
</defaultProxy>
</system.net>
</configuration>