/ define (خيارات المحول البرمجي C#)
الخيار /define يعرّف name كرمز في كل ملفات التعليمات البرمجية للمصدر في البرنامج الخاص بك.
/define:name[;name2]
الوسيطات
- name, name2
اسم رمز أو أكثر من الرموز التي تريد تعريفها.
ملاحظات
الخيار /define له نفس التأثير عند استخدام توجيه المعالج الأوّلي #define فيما عدا أنه يتم تطبيق خيار برنامج التحويل البرمجي لـكل الملفات في المشروع. يبقى رمز معرف في ملف المصدر حتى يقوم التوجيه #undef في ملف المصدر بإزالة التعريف. عند استخدام الخيار /define , التوجيه #undef في ملف واحد ليس له أي تأثير على ملفات التعليمات البرمجية الأخرى في المشروع.
يمكنك استخدام الرموز التي تم إنشاؤها بواسطة هذا الخيار مع #if و #elseو #elifو #endif للتحويل البرمجي المشروط لملفات المصدر.
/d هو النموذج القصير من**/define**.
يمكنك تحديد رموز متعددة بـ /define عن طريق استخدام فاصلة منقوطة أو فاصلة لفصل أسماء الرموز. فعلى سبيل المثال:
/define:DEBUG;TUESDAY
المحول البرمجي #C نفسه لا يعرّف رموز أو وحدات ماكرو التي يمكنك أن تستخدمها في التعليمات البرمجية الخاصة بك ; كافة تعريفات الرموز يجب أن تكون معرّفة بواسطة المستخدم.
ملاحظة
#define الخاص بـ #C لا يسمح بإعطاء قيمة لرمز كما في لغات مثل ++C. على سبيل المثال، #define لا يمكن استخدامه في إنشاء وحدة ماكرو أو لتعريف ثابت. إذا كنت تحتاج صواب لتعريف ثابت, استخدم المتغير enum. إذا كنت تريد إنشاء ماكرو بنمط ++C خذ في الاعتبار بدائل مثل العوام. حيث أن وحدات الماكرو معروفة بأنها أقل عرضة للأخطاء ، #C لا يسمح باستخدامها ولكن يوفر بدائل أكثر أماناً.
لتعيين خيار المحول البرمجي هذا في بيئة تطوير Visual Studio
افتح صفحة خصائص للمشروع.
في علامة تبويب بنية ، اكتب الرمز الذي يتم تعريفه في خانة رموز التحويل البرمجي الشرطي. على سبيل المثال، في حالة استخدام مثال التعليمات البرمجية التالي اكتب فقط xx داخل مربع النص.
للحصول على معلومات حول تعيين خيار المحول البرمجي هذا بشكل برمجي, راجع DefineConstants.
مثال
// preprocessor_define.cs
// compile with: /define:xx
// or uncomment the next line
// #define xx
using System;
public class Test
{
public static void Main()
{
#if (xx)
Console.WriteLine("xx defined");
#else
Console.WriteLine("xx not defined");
#endif
}
}