WebProxy.BypassProxyOnLocal Eigenschaft

Definition

Namespace:

System.Net

Assembly:

System.Net.WebProxy.dll

Assembly:

System.dll

Assembly:

netstandard.dll

Ruft einen booleschen Wert ab, der angibt, ob der Proxyserver für lokale Adressen umgangen werden soll, oder legt ihn fest.

public:
 property bool BypassProxyOnLocal { bool get(); void set(bool value); };

public bool BypassProxyOnLocal { get; set; }

member this.BypassProxyOnLocal : bool with get, set

Public Property BypassProxyOnLocal As Boolean

Eigenschaftswert

Boolean

true, wenn der Proxyserver für lokale Adressen umgangen werden soll, andernfalls false. Der Standardwert ist false.

Beispiele

Im folgenden Codebeispiel wird das Aufrufen eines Konstruktors veranschaulicht, der diese Eigenschaft festlegt und den Wert dieser Eigenschaft erhält.

WebProxy^ CreateProxyWithHostAddress( bool bypassLocal )
{
   WebProxy^ proxy = gcnew WebProxy( "http://contoso",bypassLocal );
   Console::WriteLine( "Bypass proxy for local URIs?: {0}", 
      proxy->BypassProxyOnLocal );
   return proxy;
}

public static WebProxy CreateProxyWithHostAddress(bool bypassLocal)
{
    WebProxy proxy =  new WebProxy("http://contoso", bypassLocal);
    Console.WriteLine("Bypass proxy for local URIs?: {0}",
       proxy.BypassProxyOnLocal);
    return proxy;
}

Hinweise

Die Einstellung der BypassProxyOnLocal Eigenschaft bestimmt, ob WebRequest Instanzen den Proxyserver beim Zugriff auf lokale Internetressourcen verwenden.

Wenn BypassProxyOnLocaltrue ist, wird bei Anforderungen an lokale Internetressourcen der Proxyserver nicht verwendet. Lokale Anforderungen werden durch den Mangel eines Punkts (.) im URI, wie in http://webserver/, oder zugriff auf den lokalen Server, einschließlich http://localhost, http://loopbackoder http://127.0.0.1zugreifen. Wenn BypassProxyOnLocalfalse ist, werden alle Internetanforderungen über den Proxyserver ausgeführt.

Hinweis

Anforderungen an einen lokalen Host mit einem URI, der einen Zeitraum enthält, verwenden den Proxy. Um die Verwendung eines Proxys in diesen Fällen zu vermeiden, erstellen Sie einen Eintrag für den Host im BypassList.