Value
خاصية TheValue هو للإشارة إلى القيمة إرجاع غير صالح لدالة المتصل-بواسطة mهوtake-قد اختبار لمعرفة ما إذا كانت دالة نجحت أو فشلت. يتم السماح بهذه خاصية تشغيل InvalidCheck سمة.
السمة InvalidCheck وخاصية "القيمة" بتوفير إليه للمساعدة في اختبار من صحة القيمة المرجعة من دالة. محاولة لحل المشكلة التي تحدث عادة عند إرجاع دالة 1 للنجاح و 0 للفشل ودالة أخرى بإرجاع 1 للنجاح و-1 للإشارة إلى فشل. يؤدي استخدام قيم مختلفة قليلاً للإشارة إلى نتائج مختلفة التشويش و لذلك يقدم أخطاء في تعليمات برمجية. بإدخال تعليق توضيحي الدالات استخدام قيمة خاصية، يمكنك تعليمات المتصلين بالتحقق من صحة القيمة المرجعة.
مثال
يلي تعليمات برمجية يوضح كيفية استخدام خاصية القيمة:
#include <CodeAnalysis\SourceAnnotations.h>
[returnvalue:SA_InvalidCheck(Value=0)] int f( ); // 1 and -1 are valid
القيمة = 0 يشير إلى أن البحث عن قيمة الإرجاع ل 0 هو خطأ لأن th هو يمكن أن ترجع دالة 1 أو-1 و 0 هو القيمة غير صالحة.
موقع المكالمات، تحذير هو هو sued إذا كان المتصل بفحص قيمة الإرجاع باستخدام التعليمة البرمجية التالية لأنك 0 هو عدم إرجاع قيمة صحيحة:
if ( f() == 0 )
راجع أيضًا:
المبادئ
نظرة عامة حول التعليقات التوضيحية