ValidElements
تحدد خاصية ValidElements أما عدد البايتات لصفيف أو المخزن مؤقت المشار إليه بمؤشر التي يمكن قراءتها بشكل قانوني. هذه خاصية هي مسموح بها تشغيل السمات ما قبل وبعد ويمكن استخدامها تشغيل مؤشر أو صفيفة أنواع بيانات. الالقيمة من القيم بالموضع هو خاصية هو تعبير الذي يتضمن معلمة أخرى، والذي يحدد العدد الفعلي لعناصر صالحة.
مثال
يلي تعليمات برمجية يوضح كيفية استخدام خاصية ValidElements:
// C
#include <CodeAnalysis\SourceAnnotations.h>
void f([SA_Pre(ValidElements="count") ] char *pc, size_t count);
// The keyword 'return' is used to indicate the return value,
// which in this case is the number of valid elements.
[returnvalue:SA_Post(MustCheck=SA_Yes)]int f([SA_Post(ValidElements="return")] char *pc);
// C++
#include <CodeAnalysis\SourceAnnotations.h>
using namespace vc_attributes;
void f([Pre(ValidElements="count") ] char *pc, size_t count);
// The keyword 'return' is used to indicate the return value,
// which in this case is the number of valid elements.
[returnvalue:Post(MustCheck=Yes)]int f([Post(ValidElements="return")] char *pc);
راجع أيضًا:
المبادئ
نظرة عامة حول التعليقات التوضيحية