GlobalProxySelection.Select-Eigenschaft

Ruft den globalen HTTP-Proxy ab oder legt diesen fest.

Namespace: System.Net
Assembly: System (in system.dll)

Syntax

'Declaration
Public Shared Property Select As IWebProxy
'Usage
Dim value As IWebProxy

value = GlobalProxySelection.Select

GlobalProxySelection.Select = value

public static IWebProxy Select { get; set; }

public:
static property IWebProxy^ Select {
    IWebProxy^ get ();
    void set (IWebProxy^ value);
}

/** @property */
public static IWebProxy get_Select ()

/** @property */
public static void set_Select (IWebProxy value)

public static function get Select () : IWebProxy

public static function set Select (value : IWebProxy)

Eigenschaftenwert

Ein IWebProxy, der bei jedem Aufruf von HttpWebRequest.GetResponse verwendet wird.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentNullException	Der für einen set-Vorgang angegebene Wert war NULL (Nothing in Visual Basic).
SecurityException	Der Aufrufer verfügt nicht über die Berechtigung für die angeforderte Operation.

Hinweise

Die Select-Eigenschaft legt den Proxy fest, den alle WebRequest-Instanzen verwenden, wenn die Anforderung Proxys unterstützt und kein Proxy mithilfe der Proxy-Eigenschaft explizit festgelegt wurde. Proxys werden gegenwärtig von FtpWebRequest und HttpWebRequest unterstützt.

Beispiel

Im folgenden Codebeispiel wird die Select-Eigenschaft auf ein leeres Proxy festgelegt.

using System;
using System.Net;
using System.IO;
namespace Examples.Http
{
    public class TestGlobalProxySelection
    {
        public static void Main()
        {
            // Create a request for the Web page at www.contoso.com.
            WebRequest request = WebRequest.Create("https://www.contoso.com");
            // This application doesn't want the proxy to be used so it sets 
            // the global proxy to an empty proxy.
            IWebProxy myProxy = GlobalProxySelection.GetEmptyWebProxy();
            GlobalProxySelection.Select = myProxy;
            // Get the response.
            WebResponse response = request.GetResponse();
            // Display the response to the console.
            Stream stream = response.GetResponseStream();
            StreamReader reader = new StreamReader(stream);
            Console.WriteLine(reader.ReadToEnd());
            // Clean up.
            reader.Close();
            stream.Close();
            response.Close();
        }
    }
}

#using <System.dll>

using namespace System;
using namespace System::Net;
using namespace System::IO;
int main()
{
   
   // Create a request for the Web page at www.contoso.com.
   WebRequest^ request = WebRequest::Create( L"https://www.contoso.com" );
   
   // This application doesn't want they proxy to be used so it sets
   // the global proxy to an empy proxy.
   IWebProxy^ myProxy = GlobalProxySelection::GetEmptyWebProxy();
   
   // Get the response.
   WebResponse^ response = request->GetResponse();
   
   // Display the response to the console.
   Stream^ stream = response->GetResponseStream();
   StreamReader^ reader = gcnew StreamReader( stream );
   Console::WriteLine( reader->ReadToEnd() );
   
   // Clean up.
   reader->Close();
   stream->Close();
   response->Close();
   return 0;
}

package Examples.Http;

import System.*;
import System.Net.*;
import System.IO.*;

public class TestGlobalProxySelection
{
    public static void main(String[] args)
    {
        // Create a request for the Web page at www.contoso.com.
        WebRequest request = WebRequest.Create("https://www.contoso.com");
        // This application doesn't want they proxy to be used so it sets 
        // the global proxy to an empy proxy.
        IWebProxy myProxy = GlobalProxySelection.GetEmptyWebProxy();
        GlobalProxySelection.set_Select(myProxy);
        // Get the response.
        WebResponse response = request.GetResponse();
        // Display the response to the console.
        Stream stream = response.GetResponseStream();
        StreamReader reader = new StreamReader(stream);
        Console.WriteLine(reader.ReadToEnd());
        // Clean up.
        reader.Close();
        stream.Close();
        response.Close();
    } //main
} //TestGlobalProxySelection

.NET Framework-Sicherheit

• WebPermission  zum Abrufen oder Festlegen des globalen HTTP-Proxys. Zugeordnete Enumeration: Unrestricted

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

Siehe auch

Referenz

GlobalProxySelection-Klasse
GlobalProxySelection-Member
System.Net-Namespace