قائمة السمة
تحديد السمات التي ستطبق على عنصر برمجة المُعلَن. السمات المتعددة تفصل بفواصل. فيما يلي بناء الجملة للسمة واحد.
[ attributemodifier ] attributename [ ( attributearguments | attributeinitializer ) ]
الأجزاء
attributemodifier
مطلوب سمات تطبيق في بداية الملف المصدر. يمكن أن يكون الـتجميع (Visual Basic) أو وحدة نمطية.attributename
مطلوبة. اسم السمة.attributearguments
اختياري. قائمة الوسائط الموضعية الخاص بهذه السمة. يتم فصل الوسيطات المتعددة بفواصل.attributeinitializer
اختياري. قائمة مُهيآت المتغير أو هذه الخاصية الخاص بهذه سمة. يتم فصل المتغيرات المتعددة بفواصل.
ملاحظات
يمكنك تطبيق سمة أو أكثر من السمات إلى تقريبًا أي عنصر برمجة (أنواع الإجراءات ، والخصائص وهكذا دواليك). تظهر السمات في بيانات التعريف الخاص بك تجميع وتساعدك لإضافة تعليقات تعليمات برمجية الخاصة بك أو تحديد كيفية استخدام عنصر برمجة معينة. يمكنك تطبيق السمات التي تم تعريفها بواسطة Visual Basic .NET Framework ثم يمكنك تعريف السمات خاصة بك.
للحصول معلومات أكثر حول متى يمكن استخدام السمات، راجع دعم Visual Basic و Visual C#. للحصول تشغيل معلومات حول سمة أسماء, راجع أسماء العنصر المعرف.
القواعد
موضع. يمكنك تطبيق سمات إلى الأكثر تعريف عناصر البرمجة. تطبيق سمة أو أكثر من السمات قم بوضع حظر السمة في بداية تعريف عنصر. يحدد كل إدخال في قائمة السمات السمة التي ترغب لتطبيقها، المعدّل و الوسيطات التي تستخدمها في استدعاء هذه السمة.
أقواس الزاوية(<>) في حالة سمة القائمة، يجب وضع ذلك في أقواس معقوفة ("<"و">").
جزء من التعريف. يجب أن تكون سمة جزءاً من تعريف وليس عبارة عنصر منفصل. يمكنك استخدام تسلسل متابعة السطر (" _") لتوسيع عبارة التعريف إلى عدة أسطر من تعليمات برمجية المصدر.
معدلات &معدّل سمة (Assembly أو Module) مطلوباً على كل سمة تم تطبيقها عنصر برمجة في بداية مصدر ملف. معدّلات سمة غير مسموح بها على سمات تطبيق إلى عناصر غير موجودة في بداية الملف المصدر.
الوسيطات يجب أن يسبق الكل الوسائط الموضعية لسمة المُهيآت أي متغير أو خاصية.
مثال
تطبيق المثال التاليDllImportAttribute سمة إلى أجزاء هيكل تعريف Function.
<DllImportAttribute("kernel32.dll", EntryPoint:="MoveFileW",
SetLastError:=True, CharSet:=CharSet.Unicode,
ExactSpelling:=True,
CallingConvention:=CallingConvention.StdCall)>
Public Shared Function moveFile(ByVal src As String,
ByVal dst As String) As Boolean
' This function copies a file from the path src to the path dst.
' Leave this function empty. The DLLImport attribute forces calls
' to moveFile to be forwarded to MoveFileW in KERNEL32.DLL.
End Function
DllImportAttribute يشير إلى أن إجراء السمات يمثل مؤشر إدخال في مكتبة ارتباط الديناميكي "(DLL) غير مدار. توفر سمة اسم DLL كوسيطة الموضعية والمعلومات الأخرى مثل المُهيآت متغير.
راجع أيضًا:
المهام
كيفية القيام بما يلي: فصل و دمج عبارات في التعليمات البرمجية