RestSharp-Proxy-Einstellungen mit RestClientOptions.Proxy

In der Konfigurations-API von RestSharp v114.1 ist ein expliziter Netzwerkproxy eine Client-Option:

var options = new RestClientOptions("https://api.example.com")
{
    Proxy = new WebProxy("http://proxy.example:8080")
};
using var client = new RestClient(options);

Dieses Fragment verwendet RestSharp und System.Net. Die Basis-URL benennt die API; die WebProxy-Adresse benennt den Vermittler. Auf einer unterstützten Laufzeit kann ein zulässiger Test einer öffentlichen API ohne Proxy-Authentifizierung einen Kandidaten aus der HTTP-Proxy-Liste für diesen Vermittler verwenden. Setzen Sie alle erforderlichen Proxy-Anmeldedaten auf diesem WebProxy, bevor Sie den Client erstellen.

RestSharp wandelt Konstruktoroptionen in eine unveränderliche Konfiguration um. Das Inspizieren von client.Options wird unterstützt; den Proxy dort nach der Erstellung zu ändern, ist nicht das Einrichtungsmuster. Behalten Sie den konfigurierten Client für seine Aufgabe und erstellen Sie einen anderen konfigurierten Client, wenn die Anwendung eine andere Route benötigt.

Wenn Sie einen vorhandenen HttpClient oder einen benutzerdefinierten Nachrichtenhandler bereitstellen, konfigurieren Sie dessen Transport selbst. RestSharp baut einen extern gehaltenen Handler nicht aus Proxy in den Optionen neu auf. Eine Route, die nicht verwendeten Optionen zugewiesen ist, kann eine von diesem Handler geöffnete Verbindung nicht ändern.

Die dokumentierte Proxy-Option hat Plattformgrenzen, darunter Browser-, iOS- und tvOS-Clients. Passen Sie das Beispiel an die verwendete Laufzeit an. Ältere RestSharp-Beispiele, die eine veränderliche Eigenschaft client.Proxy zuweisen, gehören zu einer anderen API-Generation.