<proxy> , element (ustawienia sieci)

  • Artykuł

Definiuje serwer proxy.

<Konfiguracji>
  <system.net>
    <Defaultproxy>
      <proxy>

Składnia

<proxy
  autoDetect="True|False|Unspecified"
  bypassonlocal="True|False|Unspecified"
  proxyaddress="uriString"
  scriptLocation="uriString"
  usesystemdefault="True|False|Unspecified"
/>

Atrybuty i elementy

W poniższych sekcjach opisano atrybuty, elementy podrzędne i elementy nadrzędne.

Atrybuty

Atrybut Opis
autoDetect Określa, czy serwer proxy jest wykrywany automatycznie. Wartość domyślna to Unspecified.
bypassonlocal Określa, czy serwer proxy jest pomijany dla zasobów lokalnych. Zasoby lokalne obejmują serwer lokalny (http://localhost, http://loopbacklub http://127.0.0.1) i identyfikator URI bez kropki (http://webserver). Wartość domyślna to Unspecified.
proxyaddress Określa identyfikator URI serwera proxy do użycia.
scriptLocation Określa lokalizację skryptu konfiguracji. Nie należy używać atrybutu bypassonlocal z tym atrybutem.
usesystemdefault Określa, czy używać ustawień serwera proxy systemu. Jeśli zostanie ustawiona wartość True, kolejne atrybuty zastąpią ustawienia serwera proxy systemu. Wartość domyślna to Unspecified.

Elementy podrzędne

Brak.

Elementy nadrzędne

Element Opis
Defaultproxy Konfiguruje serwer proxy protokołu HTTP (Hypertext Transfer Protocol).

Wartość tekstowa

Uwagi

Element proxy definiuje serwer proxy dla aplikacji. Jeśli w pliku konfiguracji brakuje tego elementu, .NET Framework użyje ustawień serwera proxy systemu.

Wartość atrybutu proxyaddress powinna być dobrze sformułowanym wskaźnikiem ujednoliconego zasobu (URI).

Atrybut scriptLocation odnosi się do automatycznego wykrywania skryptów konfiguracji serwera proxy. Klasa WebProxy podejmie próbę zlokalizowania skryptu konfiguracji (zwykle o nazwie Wpad.dat), gdy dla połączenia we właściwościach Internetu wybrano opcję Użyj skryptu automatycznej konfiguracji . Jeśli bypassonlocal jest ustawiona na dowolną wartość, scriptLocation zostanie zignorowana.

Wyjątek jest zgłaszany, jeśli proxyaddress atrybut określa nieprawidłowy domyślny serwer proxy. Właściwość InnerException wyjątku powinna zawierać więcej informacji na temat głównej przyczyny błędu.

Pliki konfiguracji

Ten element może być używany w pliku konfiguracji aplikacji lub pliku konfiguracji maszyny (Machine.config).

Przykład

W poniższym przykładzie użyto wartości domyślnych z serwera proxy systemu, określa adres serwera proxy i pomija serwer proxy na potrzeby dostępu lokalnego.

<configuration>  
  <system.net>  
    <defaultProxy>  
      <proxy  
        usesystemdefault="True"  
        proxyaddress="http://192.168.1.10:3128"  
        bypassonlocal="True"  
      />  
    </defaultProxy>  
  </system.net>  
</configuration>

Zobacz też