كيفية القيام بما يلي: تعريف قائمة تعداد

مقالة
11/01/2010

إنشاء قائمة تعداد مع عبارة Enum في مقطع التعريفات لفئة أو وحدة نمطية. لايمكنك تعريف قائمة تعداد داخل أسلوب. لتحديد مستوى الوصول المناسب, استخدم Private, Protected, Friend، أو Public.

نوع Enum له اسم، نوع أساسي و مجموعة من الحقول، كل منها يمثل ثابت. يجب أن يكون الاسم مؤهل Visual Basic 2005 صالح. النوع الأساسي يجب أن يكون أحد أنواع العدد الصحيح — Byte, Short, Long أو Integer. يكون الإعداد الافتراضي هو Integer. قوائم التعدادات دائماً تكون محددة النوع بشدة ولا تكون قابلة للتبادل مع أنواع رقم العدد الصحيح.

لا يمكن لقوائم التعدادات أن تحتوي قيم الفاصلة العائمة. إذا تم تعيين قائمة تعداد لقيمة فاصلة عائمة مع Option Strict On، ينتج خطأ في المحول برمجي. إذا كان Option Strict هو Off، يتم تحويل القيمة تلقائياً إلى نوع Enum.

للحصول على معلومات حول أسماء، وكيفية استخدام العبارة Imports للتأكد من أن تأهيل الاسم غير ضروري, راجع قوائم التعدادات و تأهيل الاسم.

لتعريف قائمة تعداد

قم بكتابة تعريف يتضمن تعليمات برمجية لمستوى الوصول، الكلمة الأساسية Enum و اسم صالح, كما هو موضح في الأمثلة التالية، كل ممن يعرّف Enum مختلف.

Private Enum SampleEnum
        SampleMember
    End Enum
    Public Enum SampleEnum2
        SampleMember
    End Enum
    Protected Enum SampleEnum3
        SampleMember
    End Enum
    Friend Enum SampleEnum4
        SampleMember
    End Enum
    Protected Friend Enum SampleEnum5
        SampleMember
    End Enum

قم بتعريف الثوابت في قائمة التعداد. بشكل افتراضي, يتم تهيئة أول ثابت في قائمة تعداد إلى 0، يتم تهيئة ثوابت لاحقة إلى قيمة أكبر بواحد من الثابت السابقة. على سبيل المثال، قائمة التعداد التالية, Days، تحتوي على ثابت باسم Sunday مع القيمة 0، ثابت باسم Monday مع القيمة 1، ثابت باسم Tuesday مع قيمة 2، وهكذا.
```
Public Enum Days
  Sunday
  Monday
  Tuesday
  Wednesday
  Thursday
  Friday
  Saturday
End Enum
```
يمكنك تعيين قيم إلى ثوابت في قائمة تعداد باستخدام عبارة تعيين بشكل صريح. يمكنك تعيين أي قيمة لعدد صحيح، بما في ذلك الأرقام السالبة. على سبيل المثال، قد تحتاج ثوابت مع قيم أقل من الصفر لتمثل شروط خطأ. في قائمة التعداد التالية، الثابتة Invalid معين بشكل صريح للقيمة –1, و الثابت Sunday معين للقيمة 0. لأنه الثابت الأول في قائمة التعداد، Saturday هو أيضاً تمت تهيئته إلى القيمة 0. قيمة Monday هي 1 ( أكبر بواحد من قيمة Sunday); قيمة Tuesday هي 2، و هكذا.
```
Public Enum WorkDays
  Saturday
  Sunday = 0
  Monday
  Tuesday
  Wednesday
  Thursday
  Friday
  Invalid = -1
End Enum
```

و مثال التعليمات البرمجية هذا يتوفر أيضاً باسم أجزاء التعليمات البرمجية المتحسسة الذكية (IntelliSense) . و في منتقي أجزاء التعليمات البرمجية المتكررة, إنها موجودة في لغة Visual Basic . لمزيد من المعلومات، راجع كيفية: إدراج أجزاء التعليمات البرمجية "التحسس الذكي.