<DefaultProxy >-Element (Netzwerkeinstellungen)<defaultProxy> Element (Network Settings)

Konfiguriert den HTTP-Proxyserver (Hypertext Transfer Protocol).Configures the Hypertext Transfer Protocol (HTTP) proxy server.

<configuration><configuration>
<system.net><system.net>
<defaultProxy><defaultProxy>

SyntaxSyntax

<defaultProxy  
  enabled="true|false"  
  useDefaultCredentials="true|false">  
    <bypasslist>...</bypasslist>  
    <proxy>...</proxy>  
    <module>...</module>  
</defaultProxy>

Attribute und ElementeAttributes and Elements

In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.The following sections describe attributes, child elements, and parent elements.

AttributeAttributes

ElementElement BeschreibungDescription
enabled Gibt an, ob ein Webproxy verwendet wird.Specifies whether a web proxy is used. Der Standardwert ist true.The default value is true.
useDefaultCredentials Gibt an, ob die Standardanmeldeinformationen für diesen Host für den Zugriff auf den Webproxy verwendet werden.Specifies whether the default credentials for this host are used to access the web proxy. Der Standardwert ist false.The default value is false.

Untergeordnete ElementeChild Elements

ElementElement BeschreibungDescription
bypasslistbypasslist Gibt einen Satz von regulären Ausdrücken zur Beschreibung der Adressen an, die keinen Proxy verwenden.Provides a set of regular expressions that describe addresses that do not use the proxy.
modulemodule Fügt der Anwendung ein neues Proxymodul hinzu.Adds a new proxy module to the application.
proxyproxy Definiert einen Proxyserver.Defines a proxy server.

Übergeordnete ElementeParent Elements

ElementElement BeschreibungDescription
system.netsystem.net Enthält Einstellungen, die festlegen, wie Verbindungen zwischen .NET Framework und dem Netzwerk hergestellt werden.Contains settings that specify how the .NET Framework connects to the network.

HinweiseRemarks

Wenn das defaultProxy-Element leer ist, werden die Proxyeinstellungen von Internet Explorer verwendet.If the defaultProxy element is empty, the proxy settings from Internet Explorer will be used. Dieses Verhalten unterscheidet sich von .NET Framework 1.1.This behavior is different from version 1.1 of the .NET Framework.

Eine Ausnahme wird ausgelöst, wenn die Modul Element gibt einen nicht öffentlichen Typ, der Typ nicht abgeleitet ist die IWebProxy -Klasse, eine Ausnahme vom Standardkonstruktor dieses Objekts aufgetreten ist, oder eine Ausnahme aufgetreten ist zwar das System angegebenen Standardproxys werden abgerufen.An exception is thrown if the module element specifies a non-public type, the type is not deriving from the IWebProxy class, an exception from the default constructor of this object occurred, or an exception occurred while retrieving the system-specified default proxy. Die InnerException-Eigenschaft für die Ausnahme muss zusätzliche Informationen zur Fehlerursache enthalten.The InnerException property on the exception should have more information about the root cause of the error.

KonfigurationsdateienConfiguration Files

Dieses Element kann in der Anwendungskonfigurationsdatei oder in der Computerkonfigurationsdatei ("Machine.config") verwendet werden.This element can be used in the application configuration file or the machine configuration file (Machine.config).

BeispielExample

Das folgende Beispiel verwendet die Standardeinstellungen des Internet Explorer-Proxys, gibt die Proxyadresse und umgeht den Proxy für lokale und "contoso.com".The following example uses the defaults from the Internet Explorer proxy, specifies the proxy address, and bypasses the proxy for local access and 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>  

Siehe auchSee also