فهم خاصية Flags في تعداد C#

في عالم البرمجة، وخاصة في C#، تعد التعدادات (أو enums) وسيلة شائعة لتعريف مجموعة من الثوابت المسماة. ومع ذلك، قد تصادف غالبًا تعدادات محددة بخاصية Flags وتتساءل عما يعنيه ذلك وكيفية استخدامها بشكل فعال. في هذه التدوينة، سنتعمق في غرض خاصية [Flags] في C#، موفرين لك أمثلة واضحة وشروحات لتعزيز فهمك.

ماذا تفعل خاصية [Flags] في التعداد؟

خاصية [Flags] في C# هي خاصية خاصة تسمح للتعداد بتمثيل مجموعة من القيم. هذا مفيد بشكل خاص عند التعامل مع خيارات متعددة أو إعدادات في وقت واحد. بدلاً من وجود قيمة واحدة فقط، يمكن أن يحتمل التعدادات المميزة بخاصية [Flags] تركيبة بتية من القيم التي يمكن دمجها أو فحصها بكفاءة.

متى يجب استخدام [Flags]؟

يجب تطبيق خاصية [Flags] عندما يمكن دمج قيم التعداد في مجموعة. غالبًا ما يتوافق ذلك مع الإعدادات أو الخيارات التي يمكن أن تتواجد في وقت واحد. يتم تعريف التعدادات بقوى الرقم اثنان، والتي تمثل بتات فردية.

مثال على إعلان تعداد

إليك مثال على إعلان تعداد باستخدام خاصية [Flags]:

[Flags]
public enum Options 
{
    None    = 0,    // 0b0000 - لا توجد خيارات محددة
    Option1 = 1,    // 0b0001 - الخيار 1
    Option2 = 2,    // 0b0010 - الخيار 2
    Option3 = 4,    // 0b0100 - الخيار 3
    Option4 = 8     // 0b1000 - الخيار 4
}

استخدام العمليات البتية

من خلال الإعلان أعلاه، يمكنك دمج هذه القيم باستخدام عملية OR بتية (|). على سبيل المثال:

var allowedOptions = Options.Option1 | Options.Option3;

في هذه الحالة، يمثل allowedOptions الآن كل من Option1 و Option3.

فوائد خاصية [Flags]

تحسين القراءة

واحدة من أكبر مزايا استخدام خاصية [Flags] هي أنها تجعل مخرجات طريقة .ToString() أكثر قراءة. اعتبر هذا المثال:

var myOptions = Options.Option1 | Options.Option3;
Console.WriteLine(myOptions.ToString()); // الناتج: "Option1, Option3"

على العكس، إذا لم تستخدم خاصية [Flags]:

enum Suits { Spades = 1, Clubs = 2, Diamonds = 4, Hearts = 8 }
var mySuits = (Suits.Spades | Suits.Diamonds);
Console.WriteLine(mySuits.ToString()); // الناتج: "5"

اعتبارات مهمة

• يجب أن تكون القيم قوى من اثنين: من الضروري تعيين قيم التعداد كقوى من الرقم اثنان (1، 2، 4، 8، إلخ) لعمليات بتية صحيحة. إذا لم تفعل ذلك، فقد لا تكون النتائج كما هو متوقع.

  إعلان غير صحيح:

[Flags]
public enum MyColors
{
    Yellow,  // 0
    Green,   // 1
    Red,     // 2
    Blue     // 3
}

سيجعل ذلك تعداد MyColors غير فعّال لأغراض العلامات.

مثال إعلان صحيح

[Flags]
public enum MyColors
{
    Yellow = 1, // 0b0001
    Green = 2,  // 0b0010
    Red = 4,    // 0b0100
    Blue = 8    // 0b1000
}

التحقق من العلامة

يمكنك بسهولة التحقق مما إذا كانت علامة معينة مضبوطة باستخدام طريقة HasFlag():

if (allowedOptions.HasFlag(Options.Option1))
{
    // الخيار 1 مسموح به
}

قبل .NET 4، يمكنك استخدام عملية AND بتية بدلاً من ذلك:

if ((allowedOptions & Options.Option1) == Options.Option1)
{
    // الخيار 1 مسموح به
}

فهم قيمة None

بشكل عام، تمثل قيمة None في التعدادات المزينة بـ [Flags] أنه لا توجد خيارات محددة، والتي يمثلها الرقم صفر. ومع ذلك، تذكر أن استخدام قيمة None في العمليات البتية سيؤدي دائمًا إلى الصفر، لذلك يفضل استخدام المقارنات المنطقية:

if (allowedOptions == Options.None)
{
    // لا توجد خيارات محددة
}

الخاتمة

توفر خاصية [Flags] مرونة ووضوح في العمل مع التعدادات في C#. من خلال تمكينك من تعريف تركيبات الخيارات وتحسين القراءة، فهي أداة قوية في مجموعة أدوات أي مطور. لمزيد من القراءة، يمكنك استكشاف المزيد من التفاصيل على MSDN.

يمكن أن يؤدي استخدام خاصية [Flags] في التعدادات بشكل فعال إلى تحسين كيفية إدارة خيارات متعددة ذات صلة في تطبيقاتك الخاصة بـ C#.