عند العمل مع التعليمات البرمجية في فيسوال ستوديو ، غالبا ما يصبح من الضروري التعليق على عدة أسطر في نفس الوقت. يمكن أن يكون هذا مفيدا ، على سبيل المثال ، عند تصحيح أخطاء أحد البرامج أو عند استبعاد قسم من التعليمات البرمجية مؤقتا.
هناك عدة طرق للتعليق على أسطر متعددة في فيسوال ستوديو:
- / * هذا تعليق
وهذا هو أيضا تعليق */
- باستخدام اختصار لوحة المفاتيح "السيطرة + ك ، السيطرة + ج":
- حدد الأسطر الضرورية من التعليمات البرمجية واضغط على اختصار لوحة المفاتيح"كترل + ك ، كترل + ج".
- باستخدام اختصار لوحة المفاتيح"السيطرة+/":
- حدد الأسطر الضرورية من التعليمات البرمجية واضغط على اختصار لوحة المفاتيح "السيطرة+/".
- من خلال التعليق على كتل التعليمات البرمجية ، يمكنك جعلها غير مرئية للمترجم ، وبعبارة أخرى ، استبعادها من الاعتبار عند تنفيذ البرنامج. هذا يساعد على توطين الأخطاء والقضاء عليها ، وكذلك يبسط التصحيح والقدرة على إظهار جزء من التعليمات البرمجية لفريق التطوير للتشاور والتحليل المشترك.
- قدرات التعليق على الكود في فيسوال ستوديو
- كيفية تطبيق التعليقات
- أمثلة على استخدام التعليقات
- التعليق على عدة أسطر من التعليمات البرمجية
- أنماط تنسيق التعليقات
- كيفية إعداد التعليق التلقائي في فيسوال ستوديو
الخطوة 1: افتح إعدادات محرر التعليمات البرمجية
الخطوة 2: تمكين التعليق التلقائي
الخطوة 3: إعداد تنسيق التعليق
نصائح مفيدة للتعليق على الكود
سؤال وجواب
كيف يمكنني التعليق على بضعة أسطر في فيسوال ستوديو?
كيف يمكنني إلغاء التعليق من خطوط متعددة في فيسوال ستوديو?
قدرات التعليق على الكود في فيسوال ستوديو
فيسوال ستوديو ، بيئة تطوير متكاملة (إيد) من مايكروسوفت ، ويوفر عدة طرق للتعليق رمز لتبسيط وتحسين عملية تطوير والحفاظ على رمز البرنامج.
تعليقات على سطر واحد:
يمكنك استخدام أحرف خاصة للتعليق على سطر واحد من التعليمات البرمجية في فيسوال ستوديو. على سبيل المثال ، يتم وضع حرف الشرطة المائلة المزدوجة "//" أمام السطر الذي تريد التعليق عليه. يشير هذا الحرف إلى أن هذا السطر ليس رمزا قابلا للتنفيذ وسيتم تجاهله بواسطة المترجم.
على سبيل المثال:
// هذا تعليق لن يتم تنفيذه
بواسطة دوسوميثينغ () ؛ / / سيتم تنفيذ هذا الرمز
تعليقات على عدة أسطر:
يمكنك استخدام أحرف خاصة للتعليق على عدة أسطر من التعليمات البرمجية في فيسوال ستوديو. على سبيل المثال ، يتم وضع الأحرف "/*" و "*/" قبل وبعد كتلة التعليمات البرمجية التي تريد التعليق عليها.
على سبيل المثال:
هذا تعليق
ذلك
لن يتم تنفيذها */
دوسوميثينغ () ؛ / / سيتم تنفيذ هذا الرمز
تعليقات لموقع توثيق الكود:
كما يوفر فيسوال ستوديو ميزات خاصة لتوثيق التعليمات البرمجية. وثائق التعليمات البرمجية هي التعليقات التي تصف ما يفعله جزء معين من التعليمات البرمجية وكيفية استخدامه. يمكن استخراج هذه الوثائق كمعلومات داعمة للمطورين أو الأدوات الأخرى.
فيسوال ستوديو لديه العديد من العناصر النحوية الخاصة لإنشاء وثائق التعليمات البرمجية. على سبيل المثال ، يمكنك استخدام "
"علامات لوصف الغرض الرئيسي من قطعة من التعليمات البرمجية:
///
/// هذه الطريقة تفعل شيئا.
///
الفراغ العام دوسوميثينغ()
{
- // رمز الطريقة
- }
- عند استخدام هذه العناصر النحوية الخاصة ، يمكن فيسوال ستوديو إنشاء تلميحات تلقائية عند التمرير فوق طريقة أو عرض الوثائق في نافذة التحسس الذكي.
باستخدام قدرات التعليق المتاحة في فيسوال ستوديو ، يمكن للمطورين جعل التعليمات البرمجية الخاصة بهم أكثر قابلية للقراءة ومفهومة ، وتسهيل دعمها والتعاون مع المطورين الآخرين.
كيفية تطبيق التعليقات
التعليقات هي عناصر رمز خاصة لا يتم تنفيذها عند تجميع أو تنفيذ برنامج. يتم استخدامها لإضافة تفسيرات وتفسيرات إلى الكود ، من أجل تسهيل فهمها وصيانتها.
هناك عدة طرق لتطبيق التعليقات على التعليمات البرمجية في فيسوال ستوديو:
تعليقات سطر واحد باستخدام الأحرف"//". يمكن إضافة هذا التعليق في أي مكان في سطر التعليمات البرمجية. سيتم اعتبار أي شيء يتجاوز الحرف "//" تعليقا ويتم تجاهله من قبل المترجم.
تعليقات متعددة الأسطر باستخدام الأحرف " / * "و"*/". يمكن أن يحتوي هذا النوع من التعليقات على أسطر متعددة من التعليمات البرمجية ولا يمكن إضافته إلا على أسطر فردية من التعليمات البرمجية. سيتم اعتبار جميع التعليمات البرمجية بين الأحرف "/*" و "*/" تعليقا وتجاهلها من قبل المترجم.
توثيق التعليقات. يستخدم هذا النوع من التعليقات لإنشاء التوثيق التلقائي. يبدأون بالشخصيات"///". قد يحتوي توثيق التعليقات على أوصاف للفئات والأساليب والحقول وأجزاء أخرى من التعليمات البرمجية ، وقد يحتوي أيضا على علامات إضافية لتنسيق المعلومات وتجميعها في الوثائق.
يعد تطبيق التعليقات على الكود ممارسة برمجة جيدة تساعدك أنت والمطورين الآخرين على فهم الكود والحفاظ عليه ، فضلا عن تبسيط تصحيح الأخطاء وإعادة هيكلة البرنامج. يمكن أن تكون التعليقات مفيدة بشكل خاص عند العودة إلى الكود الخاص بك بعد مرور بعض الوقت أو عندما تعمل مع مشاريع كبيرة حيث يعمل العديد من الأشخاص على الكود في نفس الوقت.
أمثلة على استخدام التعليقات
هناك عدة طرق للتعليق على التعليمات البرمجية في فيسوال ستوديو. يمكن استخدام التعليقات لأغراض مختلفة: شرح الكود للمطورين الآخرين ، واستبعاد أقسام معينة من التعليمات البرمجية مؤقتا من التجميع ، وترك الملاحظات لنفسك ، وما إلى ذلك.
1. تعليقات من سطر واحد:
تستخدم التعليقات أحادية السطر لوصف أسطر التعليمات البرمجية الفردية. يبدأون بأحرف مائلة مزدوجة"//". هنا مثال:
عدد الباحث = 5 ؛ / / تهيئة متغير الرقم مع القيمة 5
2. تعليقات متعددة الأسطر:
تستخدم التعليقات متعددة الأسطر للتعليق على أسطر متعددة من التعليمات البرمجية. تبدأ بالشخصيات " / * "وتنتهي بالشخصيات"*/". تعتبر جميع الخطوط بين هذه الأحرف تعليقات. هنا مثال:
/*
عدد كثافة العمليات 1 = 5;
عدد كثافة العمليات 2 = 10;
مجموع كثافة العمليات = عدد1 + عدد2;
*/
3. تعليقات شمل:
تستخدم تعليقات شمل لإنشاء وثائق للرمز باستخدام علامات خاصة. يبدأون بالشخصيات"///". هنا مثال:
///
/// طريقة تؤدي إضافة رقمين.
///
/// الرقم الأول.
/// الرقم الثاني.
/// مجموع رقمين.
إضافة كثافة العمليات (رقم كثافة العمليات 1 ، رقم كثافة العمليات 2)
{
عودة عدد1 + عدد2;
}
4. تعليقات مشروطة:
تسمح لك التعليقات الشرطية باستبعاد رمز معين من التجميع بناء على شرط. أنها تبدأ مع الأحرف "# إذا "وتنتهي مع الأحرف "# إنديف". هنا مثال:
# إذا التصحيح
وحدة التحكم.خط الكتابة ("تم تمكين وضع التصحيح.");
# آخر
وحدة التحكم.خط الكتابة ("تم تعطيل وضع التصحيح.");
# انديف
5. تعليقات لموقع تصحيح الأخطاء:
يتم استخدام تعليقات التصحيح في فيسوال ستوديو لاستبعاد أقسام معينة من التعليمات البرمجية مؤقتا من التنفيذ أثناء التصحيح. أنها تبدأ مع الأحرف "# إذا التصحيح "وتنتهي مع الأحرف "# إنديف". هنا مثال:
# إذا التصحيح
- // تصحيح رمز معين هنا
- صندوق الرسائل.إظهار ("تم تمكين وضع التصحيح.");
# انديف
وبالتالي ، تلعب التعليقات دورا مهما في التطوير وتسهل على المطورين الآخرين وعلى نفسك فهم الكود.
- التعليق على عدة أسطر من التعليمات البرمجية
- فيسوال ستوديو لديه طريقة بسيطة للتعليق على عدة أسطر من التعليمات البرمجية في نفس الوقت ، والتي يمكن أن تكون مفيدة عند التصحيح أو تعطيل مؤقتا قسم معين من التعليمات البرمجية. للقيام بذلك ، يمكنك استخدام وظيفة "حظر التعليق".
للتعليق على بضعة أسطر من التعليمات البرمجية ، اتبع هذه الخطوات البسيطة:
حدد الأسطر الضرورية من التعليمات البرمجية التي تريد التعليق عليها. يمكنك اختيار واحد أو أكثر من خطوط متتالية باستخدام مفتاح التحول.
اضغط على كترل + ك ثم كترل + ج. سيتم تطبيق هذا التعليق على جميع أسطر التعليمات البرمجية المميزة.
- ///
/// هذا هو تعليق شمل الذي يوفر وصفا للطريقة.
- ///
- مثال الفراغ العام()
- {
- // الرمز الخاص بك
}
قد تختلف أنماط تنسيق التعليقات اعتمادا على تفضيلات المبرمج أو قاعدة التعليمات البرمجية التي يعمل عليها فريق التطوير. من المهم اتباع أسلوب تنسيق التعليقات داخل المشروع من أجل جعل الكود أكثر قابلية للقراءة والفهم للمطورين الآخرين.
كيفية إعداد التعليق التلقائي في فيسوال ستوديو
في فيسوال ستوديو ، فمن الممكن لإعداد رمز التعليق التلقائي. يمكن أن يكون هذا مفيدا لإنشاء الوثائق أو تسهيل قراءة التعليمات البرمجية وفهمها.
الخطوة 1: افتح إعدادات محرر التعليمات البرمجية
- فتح الاستوديو المرئي
- حدد "أدوات" من القائمة الرئيسية
- حدد"خيارات"
- في النافذة التي تفتح ، حدد علامة التبويب "محرر النصوص" ثم لغة البرمجة التي تريد إعداد التعليق التلقائي لها
- الخطوة 2: تمكين التعليق التلقائي
في علامة التبويب" محرر النصوص "، ابحث عن قسم " التنسيق
حدد المربع بجوار الخيار "إدراج تعليقات في نص الكود"
الخطوة 3: إعداد تنسيق التعليق
ضمن قسم التنسيق ، ابحث عن الخيار "تنسيق التعليقات تلقائيا"
حدد المربع بجوار هذا الخيار إذا كنت تريد فيسوال ستوديو لتنسيق التعليقات تلقائيا وفقا لقواعد معينة.
انقر فوق الزر "إعدادات" بجوار خيار "تنسيق التعليقات تلقائيا" لتكوين قواعد تنسيق التعليقات