إعدادات وكيل RestSharp مع RestClientOptions.Proxy

في واجهة برمجة التكوين RestSharp v114.1، يُعد الوكيل الشبكي الصريح خيارًا من خيارات العميل:

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

يستخدم هذا المقطع RestSharp وSystem.Net. يسمّي عنوان URL الأساسي الواجهة؛ ويسمّي عنوان WebProxy الوسيط. على بيئة تشغيل مدعومة، يمكن لاختبار مسموح لواجهة عامة دون مصادقة وكيل أن يستخدم مرشحًا من قائمة وكلاء HTTP لذلك الوسيط. اضبط أي بيانات اعتماد مطلوبة للوكيل على ذلك WebProxy قبل إنشاء العميل.

يحوّل RestSharp خيارات المنشئ إلى تكوين غير قابل للتغيير. فحص client.Options مدعوم؛ أما تغيير الوكيل هناك بعد الإنشاء فليس نمط الإعداد. احتفظ بالعميل المهيأ لعمله، وأنشئ عميلًا مهيأً آخر عندما يحتاج التطبيق إلى مسار مختلف.

إذا وفّرت HttpClient موجودًا أو معالج رسائل مخصصًا، فاهيئ نقله بنفسك. لا يعيد RestSharp بناء معالج مملوك خارجيًا من Proxy في الخيارات. والمسار المخصص لخيارات غير مستخدمة لا يمكنه تغيير اتصال فتحه ذلك المعالج.

لخيار Proxy الموثق حدود على مستوى المنصات، بما فيها عملاء المتصفح وiOS وtvOS. طابق المثال مع بيئة التشغيل المستخدمة. أمثلة RestSharp الأقدم التي تعيّن خاصية client.Proxy قابلة للتغيير تنتمي إلى جيل آخر من الواجهة.