WebProxy.BypassProxyOnLocal-Eigenschaft
Ruft einen Wert ab, der angibt, ob der Proxyserver bei lokalen Adressen umgangen werden soll, oder legt diesen fest.
Namespace: System.Net
Assembly: System (in system.dll)
Syntax
'Declaration
Public Property BypassProxyOnLocal As Boolean
'Usage
Dim instance As WebProxy
Dim value As Boolean
value = instance.BypassProxyOnLocal
instance.BypassProxyOnLocal = value
public bool BypassProxyOnLocal { get; set; }
public:
property bool BypassProxyOnLocal {
bool get ();
void set (bool value);
}
/** @property */
public boolean get_BypassProxyOnLocal ()
/** @property */
public void set_BypassProxyOnLocal (boolean value)
public function get BypassProxyOnLocal () : boolean
public function set BypassProxyOnLocal (value : boolean)
Eigenschaftenwert
true, um den Proxyserver bei lokalen Adressen zu umgehen, andernfalls false. Der Standardwert ist false.
Hinweise
Mit dem Festlegen der BypassProxyOnLocal-Eigenschaft wird bestimmt, ob WebRequest-Instanzen den Proxyserver beim Zugriff auf lokale Internetressourcen verwenden.
Wenn BypassProxyOnLocal true ist, wird bei Anforderungen lokaler Internetressourcen der Proxyserver nicht verwendet. Lokale Anforderungen enthalten im URI keinen Punkt (.), z. B. http://webserver/, oder sie greifen auf den lokalen Server zu, z. B. https://localhost, https://loopback oder http://127.0.0.1. Wenn BypassProxyOnLocal false ist, werden alle Internetanforderungen über den Proxyserver ausgeführt.
Hinweis
Anforderungen für einen lokalen Host mit einem URI, der einen Punkt enthält, verwenden den Proxy. Erstellen Sie in der BypassList einen Eintrag für den Host, wenn der Proxy in solchen Fällen nicht verwendet werden soll.
Beispiel
Im folgenden Codebeispiel wird das Aufrufen eines Konstruktors, der diese Eigenschaft festlegt, und das Abrufen des Werts dieser Eigenschaft veranschaulicht.
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;
}
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(boolean bypassLocal)
{
WebProxy proxy = new WebProxy("http://contoso", bypassLocal);
Console.WriteLine("Bypass proxy for local URIs?: {0}",
(System.Boolean)proxy.get_BypassProxyOnLocal());
return proxy;
} //CreateProxyWithHostAddress
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0, 1.0