معلومة : XML Comments مهمة - نسخة قابلة للطباعة +- منتدى فيجوال بيسك لكل العرب | منتدى المبرمجين العرب (http://vb4arb.com/vb) +-- قسم : قسم لغة الفيجوال بيسك VB.NET (http://vb4arb.com/vb/forumdisplay.php?fid=182) +--- قسم : قسم مقالات VB.NET (http://vb4arb.com/vb/forumdisplay.php?fid=184) +--- الموضوع : معلومة : XML Comments مهمة (/showthread.php?tid=5343) |
معلومة : XML Comments مهمة - RaggiTech - 06-10-12 كاتب الموضوع : BADRMEDIA
يقول المثل الشعبي " لا غريب إلا الشيطان "أحياناً أحب أوقف كود عن العمل أو أعمل فاصل بين كودين فكنت استخدم علامة التنصيص المفردة Single Quotation ( ' ) فكنت أضغط على الزر ووجدت أنه بعد كتابة ثلاث علامات تنصيص مفردة يتكون كود كانت هيئته كود : ''' <summary> فكنت أقول بالعامية ( أيه العبط ده - سيبك منه احنا مش فاضيين ) فأصحب لما أحب أن أفصل كودين كنقطة وعلامة لى أضع علامة تنصيص واحدة وأضيف علامة أخرى لنهاية السطر الآن أصبحت اللغة تبرمجنا ولم نعد مبرمجين وهكذا الأيام لكن هدانا الله أن نعير الأمر اهتمام فقلنا لابد أنها تقنية جديدة خاصة أن الوسم الموجود يذكرنا بوسم XML وبالفعل ظهر أنها تقنية جديدة لكتابة تعليقات على كودك حتى نفهم أكثر نقوم بإنشاء مثال ليتضح المقال الآن هنكتب اجراء ونعرف فيه متغيران هكذا كود : Sub Example( _ المتغير الأول ID_Emp من نوع رقمي - عدد صحيح المتغير الثاني Name_Emp من نوع نصي اذهب للسطر قبل رأس الاجراء مباشرة واكتب ثلاث علامات تنصيص Single Quotation ( ' ) ستجد أن البيئة أنشئت كود تلقائي مباشرة بصيغة XML هيئتة كالتالي كود : ''' <summary> فماذا لو غير اسم متغير من متغيرلت الاجراء ماذا سيحدث فى الكود المكون XML ٍستجد خط اعتراضي يتم وضعه أسفل اسم المتغير فى الكود المكون XML وكذلك لو غيرته فى الكود المكون بنفسك نأتي لنقطة كتابة التعليقات فأنت الذى تقوم بكتابتها بين المعاملين أكبر من < وأصغر من > أى بين اسم المتغير وكلمة param تعنى paramter ( الوسيطات ) كود : param name="ID_Emp">هنا تضع رقم الموظف يا عم الحاج مبرمج</param> بحيث أنه استدعاء الاجراء نجد أن تقنية IntelliSense تظهر وتظهر التعليق الخاص بنا مع كل Paramter مطلوب ارساله مع استدعاء الاجراء تأتى الافادة الكبري عندما تقوم بانشاء Class او اجرائية تريد نشرها للمبرمجين وتريد أن تسهل عليهم فهم ارسال الوسيطات من حيث ماهيتها ووظيفتها وما المراد ارساله ولك كافادة فى استخدامات مشروعك أثناء صيانة برنامج لك بعد أعوام من تصميمه شئ جميل لبيئة قوية على فكرة الجزء ده اتضح لى أنه كان متاح فى بيئة C# قبل VB.Net طبعاً أن فرحت بوجوده هنا لأن مبرمجين VB.Net فى الغالب خاصة المخضرمين أقدم من مبرمجي C# حيث هم امتداد لاصدارات VB عن نفسي بدأتها من اصدار 3 لكن C# ممكن تجد مبرمجها بل الأغلب بدايته البرمجية منها هي معلومة : XML Comments مهمة - RaggiTech - 06-10-12 كاتب المشاركة : BADRMEDIA
هذا مستند كان من أجل C#http://msdn.microsoft.com/msdnmag/issues/02/06/XMLC/ والآن في اصدار 2 مستند عن التقنية http://msdn2.microsoft.com/en-us/lib...f7(VS.71).aspx |