WebProxy Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Bevat HTTP-proxyinstellingen voor de HttpClient klasse.
public ref class WebProxy : System::Net::IWebProxy, System::Runtime::Serialization::ISerializable
public ref class WebProxy : System::Runtime::Serialization::ISerializable
[System.Serializable]
public class WebProxy : System.Net.IWebProxy, System.Runtime.Serialization.ISerializable
[System.Serializable]
public class WebProxy : System.Runtime.Serialization.ISerializable
public class WebProxy : System.Net.IWebProxy, System.Runtime.Serialization.ISerializable
[<System.Serializable>]
type WebProxy = class
interface IWebProxy
interface ISerializable
type WebProxy = class
interface IWebProxy
interface ISerializable
Public Class WebProxy
Implements ISerializable, IWebProxy
Public Class WebProxy
Implements ISerializable
- Overname
-
WebProxy
- Kenmerken
- Implementeringen
Voorbeelden
In het volgende codevoorbeeld wordt een HttpClient exemplaar ingesteld met een WebProxy exemplaar. Het HttpClient exemplaar gebruikt de proxy om verbinding te maken met externe internetbronnen. (Zie de documentatie voor de IWebProxyScript klasse voor een voorbeeld dat laat zien hoe u de WPAD-functie gebruikt.)
WebProxy proxyObject = new WebProxy("http://proxyserver:80/", true);
// HttpClient lifecycle management best practices:
// https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
HttpClient client = new HttpClient(new HttpClientHandler
{
Proxy = proxyObject
});
Dim proxyObject As New WebProxy("http://proxyserver:80/", True)
' HttpClient lifecycle management best practices:
' https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
Dim client As New HttpClient(New HttpClientHandler With
{
.Proxy = proxyObject
})
Opmerkingen
De WebProxy klasse bevat de proxy-instellingen die HttpClient exemplaren gebruiken om te bepalen of een webproxy wordt gebruikt voor het verzenden van aanvragen. Globale webproxy-instellingen kunnen worden opgegeven in computer- en toepassingsconfiguratiebestanden en toepassingen kunnen exemplaren van de WebProxy klasse gebruiken om het webproxygebruik aan te passen. De WebProxy klasse is de basis-implementatie van de IWebProxy interface.
Als u exemplaren van de webproxyklasse wilt verkrijgen, kunt u een van de volgende methoden gebruiken:
- De WebProxy constructor.
- De GetDefaultProxy methode.
- De Select methode.
Deze methoden leveren elk een WebProxy exemplaar op dat u verder kunt aanpassen. Het verschil tussen deze methoden is hoe het exemplaar wordt geïnitialiseerd voordat deze wordt geretourneerd naar uw toepassing. De WebProxy constructor retourneert een exemplaar van de WebProxy klasse met de Address eigenschap ingesteld op null. Wanneer een aanvraag een WebProxy exemplaar in deze status gebruikt, wordt er geen proxy gebruikt om de aanvraag te verzenden.
De GetDefaultProxy methode retourneert een exemplaar van de WebProxy klasse met de Address, BypassProxyOnLocalen BypassList eigenschappen die zijn ingesteld op de waarden die door de lokale computer worden gebruikt.
De Select methode retourneert een exemplaar van de WebProxy klasse, waarbij deze eigenschappen zijn ingesteld op basis van een combinatie van instellingen voor internet- en configuratiebestanden.
De WebProxy klasse ondersteunt automatische detectie en uitvoering van proxyconfiguratiescripts. Deze functie wordt ook wel WPAD (Web Proxy Auto Discovery) genoemd. Wanneer u automatische proxyconfiguratie gebruikt, moet een configuratiescript, meestal Wpad.dat genoemd, zich bevinden, downloaden, compileren en uitvoeren. Als deze bewerkingen zijn geslaagd, retourneert het script de proxy's die kunnen worden gebruikt voor een aanvraag.
Constructors
| Name | Description |
|---|---|
| WebProxy() |
Initialiseert een leeg exemplaar van de WebProxy klasse. |
| WebProxy(SerializationInfo, StreamingContext) |
Initialiseert een exemplaar van de WebProxy klasse met behulp van eerder geserialiseerde inhoud. |
| WebProxy(String, Boolean, String[], ICredentials) |
Initialiseert een nieuw exemplaar van de WebProxy klasse met de opgegeven URI, bypass-instelling, lijst met URI's die moeten worden overgeslagen en referenties. |
| WebProxy(String, Boolean, String[]) |
Initialiseert een nieuw exemplaar van de WebProxy klasse met de opgegeven URI, bypass-instelling en lijst met URI's die moeten worden omzeild. |
| WebProxy(String, Boolean) |
Initialiseert een nieuw exemplaar van de WebProxy klasse met de opgegeven URI en bypass-instelling. |
| WebProxy(String, Int32) |
Initialiseert een nieuw exemplaar van de WebProxy klasse met het opgegeven host- en poortnummer. |
| WebProxy(String) |
Initialiseert een nieuw exemplaar van de WebProxy klasse met de opgegeven URI. |
| WebProxy(Uri, Boolean, String[], ICredentials) |
Initialiseert een nieuw exemplaar van de WebProxy klasse met het opgegeven Uri exemplaar, bypass-instelling, lijst met URI's die moeten worden overgeslagen en referenties. |
| WebProxy(Uri, Boolean, String[]) |
Initialiseert een nieuw exemplaar van de WebProxy klasse met de opgegeven Uri instantie, bypass-instelling en lijst met URI's die moeten worden overgeslagen. |
| WebProxy(Uri, Boolean) |
Initialiseert een nieuw exemplaar van de WebProxy klasse met het Uri exemplaar en omzeilt de instelling. |
| WebProxy(Uri) |
Initialiseert een nieuw exemplaar van de WebProxy klasse van het opgegeven Uri exemplaar. |
Eigenschappen
| Name | Description |
|---|---|
| Address |
Hiermee haalt u het adres van de proxyserver op of stelt u dit in. |
| BypassArrayList |
Hiermee haalt u een lijst op met adressen die geen gebruik maken van de proxyserver. |
| BypassList |
Hiermee haalt u een matrix van adressen op die niet gebruikmaken van de proxyserver. |
| BypassProxyOnLocal |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de proxyserver voor lokale adressen moet worden overgeslagen. |
| Credentials |
Hiermee haalt u de referenties op die moeten worden verzonden naar de proxyserver voor verificatie. |
| UseDefaultCredentials |
Hiermee wordt een Boolean waarde opgehaald of ingesteld waarmee wordt bepaald of de DefaultCredentials verzonden waarden worden verzonden met aanvragen. |
Methoden
| Name | Description |
|---|---|
| Equals(Object) |
Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object) |
| GetDefaultProxy() |
Verouderd.
Verouderd.
Leest de niet-dynamische proxyinstellingen voor internetopties. |
| GetHashCode() |
Fungeert als de standaardhashfunctie. (Overgenomen van Object) |
| GetObjectData(SerializationInfo, StreamingContext) |
Hiermee wordt een SerializationInfo gevuld met de gegevens die nodig zijn om het doelobject te serialiseren. |
| GetProxy(Uri) |
Retourneert de geproxiede URI voor een aanvraag. |
| GetType() |
Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object) |
| IsBypassed(Uri) |
Hiermee wordt aangegeven of de proxyserver voor de opgegeven host moet worden gebruikt. |
| MemberwiseClone() |
Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object) |
| ToString() |
Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object) |
Expliciete interface-implementaties
| Name | Description |
|---|---|
| ISerializable.GetObjectData(SerializationInfo, StreamingContext) |
Hiermee maakt u de serialisatiegegevens en context die door het systeem worden gebruikt om een WebProxy object te serialiseren. |