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

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

<configuration> <configuration>
  @ no__t-1 @no__t -4system. net >   <system.net>
  @ no__t-1 @ no__t-2 @ no__t-3 <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 truesein.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 falsesein.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 das Module -Element einen nicht öffentlichen Typ angibt, der Typ nicht von der IWebProxy -Klasse abgeleitet wird, eine Ausnahme vom Parameter losen Konstruktor dieses Objekts aufgetreten ist oder beim Abrufen von eine Ausnahme aufgetreten ist. vom System angegebener Standard Proxy.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 parameterless 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

Im folgenden Beispiel werden die Standardwerte aus dem Internet Explorer-Proxy verwendet, die Proxy Adresse angegeben und der Proxy für den lokalen Zugriff und contoso.com umgangen.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