استدعاء غير متزامن من كود متزامن في C#: معركة الأساليب

كيف تستدعي طريقة غير متزامنة من طريقة متزامنة في C#؟ الجوهر، لا حشو

تخيل: أنت جالس في المساء تكتب كودًا، وتنهي أداة وحدة تحكم قديمة بلغة C#. كل شيء يعمل بشكل متزامن، كالساعة. وفجأة! تحتاج إلى استدعاء API مصمم فقط عبر async Task. ألن تعيد كتابة البرنامج بأكمله؟ ألم مألوف، أليس كذلك؟

سؤال «How to call asynchronous method from synchronous method in C#» هو أحد أكثر الأسئلة شيوعًا على Stack Overflow. وليس بدون سبب. هناك، في التعليقات، أطنان من النصائح من «استخدم .Result ولا تقلق» إلى «هل أنت مجنون؟ ستحصل على deadlock!». دعنا نصنف الأمور: أي الأساليب تعمل حقًا، وأيها طريق إلى الجحيم.

لماذا لا يعمل ببساطة «await»؟

إذا حاولت كتابة:

public void SyncMethod()\n{\n    await DoSomethingAsync(); // خطأ CS4032\n}

سيرفض المترجم ببساطة ترجمته. يمكن استخدام await فقط داخل طريقة مُعلَمة بالمُعدِّل async. أما async void فهي قصة أخرى سنناقشها أيضًا.

إذن، لدينا طريقة غير متزامنة:

public async Task<string> GetDataAsync()\n{\n    using var httpClient = new HttpClient();\n    return await httpClient.GetStringAsync("https://api.example.com/data");\n}

ولدينا طريقة متزامنة نريد استدعاءها منها. لنستعرض الخيارات.

الطريقة 1: GetAwaiter().GetResult() — الأناقة الهاكر

الطريقة الأكثر شيوعًا، وربما الأكثر أناقة:

public string CallSync()\n{\n    return GetDataAsync().GetAwaiter().GetResult();\n}

لماذا هذا رائع:

\n
• لا يُنشئ استثناء AggregateException (على عكس .Result). إذا حدث خطأ داخل الطريقة غير المتزامنة، ستحصل على نوعه الأصلي، وليس غلافًا.
\n
• الكود قابل للقراءة بشكل جيد، بدون try-catch زائدة.
\n

لكن هناك فارق بسيط: إذا كانت طريقتك المتزامنة تُنفَّذ في سياق مع SynchronizationContext (مثل مؤشر ترابط واجهة المستخدم في WinForms أو WPF)، فإنك تخاطر بالحصول على deadlock — حجب متبادل للمؤشرات. المؤشر A ينتظر إكمال المهمة غير المتزامنة، والمهمة لا تستطيع الإكمال لأنها تنتظر تحرير المؤشر A. كارثة.

كيف تتجنب ذلك: استخدم .ConfigureAwait(false) داخل الطريقة غير المتزامنة نفسها. لكن هذا يغير API، وليس فقط كود الاستدعاء.

الطريقة 2: Task.Run(async () => await ...).GetAwaiter() — النقل إلى تجمع المؤشرات

إذا لم تستطع تغيير الطريقة غير المتزامنة، ولكنك تريد تجنب deadlock بشكل مضمون — انقل المهمة إلى تجمع المؤشرات:

public string CallSyncSafe()\n{\n    return Task.Run(async () => await GetDataAsync()).GetAwaiter().GetResult();\n}

السحر: Task.Run يُشغِّل المفوض على مؤشر ترابط من ThreadPool، الذي ليس لديه SynchronizationContext. deadlock مستحيل. حتى لو كانت الطريقة الأصلية تستخدم ConfigureAwait(true).

العيب: تبديل سياق إضافي (context switch). لمئات الاستدعاءات — غير مناسب. للاستدعاءات الفردية — مثالي.

الطريقة 3: .Result أو .Wait() — طريقة الجدات

public string CallSyncOldSchool()\n{\n    return GetDataAsync().Result; // أو .Wait()\n}

ما المشكلة:

\n
• عند حدوث خطأ، يُلقي AggregateException. للوصول إلى الخطأ الحقيقي، تحتاج إلى البحث في InnerException.
\n
• نفس خطر deadlock في سياق واجهة المستخدم.
\n
• الكود يبدو كحل مؤقت من عام 2012.
\n

هذه الطريقة هي قطعة قماش حمراء لمراجعة الكود. إذا رأيت شيئًا كهذا في طلب دمج (pull request) — سأرفضه.

الطريقة 4: AsyncHelper أو RunSync مخصص

أحيانًا يكتب المطورون ذوو الخبرة أدوات مساعدة خاصة بهم. على سبيل المثال، هذه: