ملاحظة تم تطوير هذا المستودع في .NETSTANDARD2+ بدعم لنتائج خدمة SOAP المستخدمة بشكل أساسي في إطار .NET (الدعم الحالي 4.5 ، 4.6.1 - 4.8)
الهدف من هذا المستودع هو توفير إمكانية إدارة الإجابات الواردة والاتفاق عليها نتيجة لتنفيذ طريقة أو عملية.
بمعنى آخر ، فإنه يوفر إمكانية استخدام استجابة واحدة (عامة) ، ونموذج منظم وأسهل تم تحليله للطرق المنفذة. نتيجة لذلك ، يمكنك التحكم في رسائل وأنواع الرسائل التي سيتم الحصول عليها.
من خلال المتابعة حاليًا ، يتم تنفيذ 6 أنواع عامة من الرسائل ( Info ، Warning ، Error ، NotFound ، AccessDenied ، Exception ) يمكن إرجاعها إلى المتصل. كما ترون في تعداد MessageType ، هناك 9 أنواع من الرسائل ، لجميع أنواع 3 ( Info ، Warning ، Error ) موجودة سابقًا مع Confirm نهايات جديدة. فكرة كل منهم هي إبلاغ واجهة المستخدم (أو المتصل) بأن الرسالة التي يتم إرجاعها سيتم تحليلها/استخدامها كمربع حوار/نافذة منبثقة/مشروط.
للاستخدام الأكثر مرونة وبديهية ، في الحل ، لا تزال طريقة التمديد مثل الوصول بطلاقة إلى تعيين الرسالة ، والخطأ ، وما إلى ذلك ( WithMessage ، WithKeyCode ، WithCodeMessage ، WithError ، WithErrors ). في بعض الحالات ، قد يكون لديك ضرورة إضافة المعلومات الإضافية في النتيجة مثل الارتباط بين طريقة تنفيذ التعليمات البرمجية واسم تخزين البيانات: الإجراء المخزن أو الدالة أو الجدول ، إلخ ؛ في التعليمات البرمجية/النتيجة يتم تعريف الكائن RelatedObject حيث يمكن تخزين هذه المعلومات وإعادتها إلى المتصل.
لاستخدام أكثر كفاءة ، عندما تكون في بعض الحالات قد تحتاج إلى تنفيذ بعض الإجراءات/الوظائف المخصصة بعد طلب تنفيذ ناجح أو فشل. في هذه الحالة ، تمت إضافة طرق تمديد ( ActionOnSuccess ، ActionOnFailure ، ActionOn ، ExecuteAction ، FunctionOnSuccess ، FunctionOnFailure ، FunctionOn ، ExecuteFunction ) التي تتيح لك تنفيذ هذا الإجراء/الوظيفة مثل إدراج سجل عندما يكون للتنفيذ حالة مساوية للفشل.
لا توجد مكونات أو حزم إضافية مطلوبة للاستخدام. لذلك ، يجب إضافته/تثبيته فقط في المشروع ويمكن استخدامه على الفور.
في حال كنت ترغب في استخدامه في مشروعك ، يمكنك تثبيت الحزمة من nuget.org أو تحديد الإصدار الذي تريده:
Install-Package AggregatedGenericResultMessage -Version xxxx