مشاركة عبر

الإرشادات التفصيلية: كتابة مصوّر مرئي في #C

  • مقالة

ينطبق هذا الموضوع على:

النسخة

Visual Basic

C#‎

#F

C++‎

مطور الويب

Express

 الموضوع الذي لا ينطبق الموضوع الذي ينطبق الموضوع الذي ينطبق الموضوع الذي لا ينطبق الموضوع الذي لا ينطبق

pro ، Premium و Ultimate

 الموضوع الذي لا ينطبق الموضوع الذي ينطبق الموضوع الذي ينطبق الموضوع الذي لا ينطبق الموضوع الذي لا ينطبق

تُظهر هذه المعاينة كيفية كتابة مصور مرئي بسيط باستخدام #C حيث يقوم المصور المرئي الذي ستقوم بإنشائه في هذه المعاينة بعرض محتويات السلسلة باستخدام نافذة رسالة Windows Forms, و لكن المصور المرئي لهذه السلسلة البسيطة ليست مفيدة بحد ذاتها لكنها تقوم بإظهار الخطوات الأساسية التي يجب عليك اتباعها لإنشاء مصورات مرئية أكثر فائدة لأنواع بيانات أخرى.

ملاحظة

قد تختلف مربعات الحوار و أوامر القائمة التى تشاهدها عن تلك الموصوفة في التعليمات ، و ذلك اعتماداً على إعداداتك النشطة أو الإصدار الخاص بك. و لتغيير الإعدادات قم بالذهاب إلى القائمة أدوات ثم اخترإعدادات الاستيراد و التصدير . لمزيد من المعلومات، راجع العمل مع إعدادات.

يجب وضع التعليمات البرمجية للمصور المرئي في DLL حيث ستتم قراءته بواسطة مصحح الأخطاء, و لذلك فإن الخطوة الأولى هى إنشاء مشروع عنصر التحكم لـ DLL.

إلى إنشاء مشروع مكتبة فئة

  1. على القائمة ملف قم باختيار جديد و من ثم انقر فوق مشروع جديد.

  2. في مربع الحوار مشروع جديد ضمن نوع المشروع قم بتحديد #Visual C.

  3. في المربع قوالب قم باختيار مكتبة الفئات.

  4. في اسم ، اكتب اسماً مناسباً للحصول مكتبة الفئات، مثل MyFirstVisualizer.

  5. انقر فوق موافق.

بعد إتمام إنشاء مكتبة الفئات يجب عليك إضافة مرجع إلى Microsoft.VisualStudio.DebuggerVisualizers.DLL حيث يمكنك استخدام الفئات المعرفة هناك, و لكن قبل أن تقوم بإضافة المرجع يجب إعادة تسمية بعض الفئات بحيث يكون لديهم أسماء ذات معنى.

لإعادة تسمية Class1.cs و إضافة Microsoft.VisualStudio.DebuggerVisualizers

  1. في مستكشف الحلول انقر بزر الماوس الأيمن فوق Class1.cs ثم قم باختيار إعادة تسمية على القائمة المختصرة.

  2. قم بتغيير الاسم من Class1.cs إلى اسم ذي معنى مثل DebuggerSide.cs.

    ملاحظة

    يقوم Visual Studio تلقائياً بتغيير تعريف الفئة في DebuggerSide.cs ليطابق اسم الملف الجديد.

  3. في مستكشف الحلول انقر بزر الماوس الأيمن فوق مراجع ثم اختر إضافة مرجع على القائمة المختصرة.

  4. في مربع الحوار إضافة مرجع على العلامة التبويب .Net قم باختيار Microsoft.VisualStudio.DebuggerVisualizers.DLL.

  5. انقر فوق موافق.

  6. في DebuggerSide.vb، إضافة العبارة التالية إلى using عبارات:

    using Microsoft.VisualStudio.DebuggerVisualizers;

أنت مستعد الآن لإنشاء التعليمات البرمجية من جانب مصحح الأخطاء, هذا تعليمات برمجية تعمل ضمن مصحح أخطاء لعرض المعلومات التي تريد عرض عرض. حيث يجب عليك أولاً تغيير التعريف للكائن DebuggerSide بحيث أن يرث من الفئة الأساسية DialogDebuggerVisualizer.

وراثة DialogDebuggerVisualizer من

  1. في DebuggerSide.cs انتقل إلى خط التعليمات البرمجية التالي:

    public class DebuggerSide

  2. قم بتغيير التعليمات البرمجية لـ:

    public class DebuggerSide : DialogDebuggerVisualizer

DialogDebuggerVisualizer لديه أسلوب ملخص واحد (Show) الذي يجب عليك منعه.

إلى كتابة فوق أسلوب DialogDebuggerVisualizer.Show

  • في public class DebuggerSide قم بإضافة أسلوب: التالي

    override protected void Show(IDialogVisualizerService windowService, IVisualizerObjectProvider objectProvider)
{
}

الأسلوب Show يحتوي على التعليمات البرمجية التي فعلياً تقوم بإنشاء مربع الحوار للمصور المرئي أو واجهة مستخدم أخرى و عرض المعلومات التي تم تمريرها إلى المصور المرئي من مصحح الأخطاء يجب إضافة تعليمات برمجية التي ينشئ مربع حوار ويعرض المعلومات. ففي هذه المعاينة سوف تقوم بتنفيذ ذلك باستخدام مربع رسالة Windows Forms, حيث يجب عليك أولاً إضافة مرجع و using كشف System.Windows.Forms.

إلى النظام.Windows.Forms إضافة

  1. في مستكشف الحلول انقر بزر الماوس الأيمن فوق مراجع ثم اختر إضافة مرجع على القائمة المختصرة.

  2. في مربع الحوار إضافة مرجع على علامة التبويب .net قم باختيار System.Windows.Forms.DLL.

  3. انقر فوق موافق.

  4. في DebuggerSide.vb، إضافة العبارة التالية إلى using عبارات:

    using System.Windows.Forms;

الآن سوف تقوم بإضافة بعض التعليمات البرمجية لإنشاء واجهة المستخدم الخاصة بك و إظهار المصور المرئي, و لأن هذا يعتبر أول مصور مرئي خاص بك سوف نحتفظ بواجهة المستخدم بسيطة و سنستخدم مربع الرسالة.

لإظهار المخرجات من المصور المرئي في مربع حوار

  1. في Show أسلوب إضافة خط تعليمات برمجية التالي:

    MessageBox.Show(objectProvider.GetObject().ToString());

    هذا المثال تعليمات برمجية لا يتضمن معالجة الأخطاء. حيث يجب عليك تضمين معالجة الأخطاء في مصور مرئي حقيقي أو أية أنواع أخرى للتطبيق.

  2. على القائمة بنية قم باختيار بنية MyFirstVisualizer يجب على المشروع البناء بنجاح. تصحيح أية أخطاء البناء قبل المتابعة.

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

لإضافة التعليمات البرمجية لجانب المصحح

  1. قم بإضافة التعليمات البرمجية للسمة التالية إلى DebuggerSide.cs بعد العبارات using و لكن قبل namespace MyFirstVisualizer:

    [assembly:System.Diagnostics.DebuggerVisualizer(
typeof(MyFirstVisualizer.DebuggerSide),
typeof(VisualizerObjectSource),
Target  = typeof(System.String),
Description  = "My First Visualizer")]

  2. على القائمة بنية قم باختيار بنية MyFirstVisualizer يجب على المشروع البناء بنجاح. تصحيح أية أخطاء البناء قبل المتابعة.

عند هذه النقطة انتهاء مصور مرئي أول. إذا تم اتباع الخطوات بشكل صحيح، يمكنك بنية مصور مرئي وإعادة تثبيته في Visual Studio. قبل يثّبت مصور مرئي ضمن Visual Studio، على الرغم من ذلك، يجب أن اختبار في تأكد من تشغيله بشكل صحيح. يتم الآن إنشاء نظام اختبار لتشغيل مصور مرئي بدون تثبيت في Visual Studio.

لإضافة أسلوب اختبار حتى يتم إظهار المصور المرئي

  1. قم بإضافة الأسلوب التالي إلى فئة public DebuggerSide .

    public static void TestShowVisualizer(object objectToVisualize)
{
   VisualizerDevelopmentHost visualizerHost = new VisualizerDevelopmentHost(objectToVisualize, typeof(DebuggerSide));
   visualizerHost.ShowVisualizer();
}

  2. على القائمة بنية قم باختيار بنية MyFirstVisualizer يجب على المشروع البناء بنجاح. تصحيح أية أخطاء البناء قبل المتابعة.

بعد ذلك، يجب أن تقوم بإنشاء مشروع تنفيذي إلى يتصل مصور مرئي DLL. و ببساطة سوف نقوم باستخدام مشروع تطبيق وحدة التحكم.

إضافة مشروع تطبيق وحدة تحكم إلى الحل

  1. على القائمة ملف قم باختيار إضافة و من ثم انقر فوق مشروع جديد.

  2. في مربع الحوار إضافة مشروع جديد في المربع قوالب قم اختيار تطبيق وحدة التحكم.

  3. في المربع اسم قم بكتاية اسماً ذا معنى لتطبيق وحدة التحكم مثل MyTestConsole.

  4. انقر فوق موافق.

والآن، يجب إضافة مراجع الضرورية حتى يمكن الاتصال MyTestConsole MyFirstVisualizer.

إلى إضافة مراجع الضرورية MyTestConsole

  1. في مستكشف الحلول انقر بزر الماوس الأيمن فوق MyTestConsole ثم اختر إضافة مرجع على القائمة المختصرة.

  2. في مربع الحوار إضافة مرجع على العلامة التبويب .Net قم باختيار Microsoft.VisualStudio.DebuggerVisualizers.DLL.

  3. انقر فوق موافق.

  4. انقر بزر الماوس الأيمن فوق MyTestConsole ثم اختر إضافة مرجع مرة أخرى.

  5. في مربع الحوار إضافة مرجع انقر فوق مشاريع ثم انقر فوق MyFirstVisualizer.

  6. انقر فوق موافق.

الآن، سيتم إضافة تعليمات برمجية لإنهاء نظام الاختبار.

لإضافة تعليمات برمجية إلى MyTestConsole

  1. في مستكشف الحلول انقر بزر الماوس الأيمن فوق Program.cs ثم قم باختيارإعادة تسمية على القائمة المختصرة.

  2. قم بتحرير الاسم من Program.cs إلى اسم ذي معنى مثل TestConsole.cs.

    ملاحظة   يقوم Visual Studio تلقائياً بتغيير تعريف الفئة في TestConsole.cs ليطابق اسم الملف الجديد.

  3. في TestConsole.cs قم بإضافة التعليمات البرمجية التالية إلى العبارات using:

    using MyFirstVisualizer;

  4. قم بإضافة التعليمات البرمجية التالية بعد الرمز Main .

    String myString = "Hello, World";
DebuggerSide.TestShowVisualizer(myString);

الآن أنت جاهز لاختبار المصور المرئي الأول الخاص بك.

لاختبار مصور مرئي

  1. في مستكشف الحلول انقر بزر الماوس الأيمن فوق MyTestConsole ثم اختر تعيين مشروع بدء التشغيل على القائمة المختصرة.

  2. على القائمة يصحح قم باختيار ابدأ.

    يبدأ تطبيق وحدة التحكم كما يظهر المصور المرئي و يعرض السلسلة "مرحباً, شبكة إنترنت".

تهانينا! يكون فقط إنشاؤها واختبارها مصور مرئي أول.

إذا كنت تريد استخدام الاتصال مصور مرئي في Visual Studio بدلاً من مجرد الاستدعاء من نظام الاختبار، تحتاج إلى تثبيته. لمزيد من المعلومات، راجع كيفية القيام بما يلي: تثبيت مصور مرئي.

باستخدام قالب العنصر للمصور المرئي

حتى الآن هذه معاينة قد أظهرت لك كيفية إنشاء مصور مرئي يدوياً و قد تم ذلك كعملية تعلم, فالآن بعد أن عرفت كيفية عمل مصور مرئي بسيط هناك طريقة أسهل لإنشاءه: باستخدام قالب العنصر للمصور المرئي.

أولاً يجب عليك إنشاء مشروع جديد لمكتبة فئات.

لإنشاء مكتبة فئات جديدة

  1. على القائمة ملف قم باختيار إضافة و من ثم انقر فوق مشروع جديد.

  2. في مربع الحوار إضافة مشروع جديد ضمن نوع المشروع قم بتحديد #Visual C.

  3. في المربع قوالب قم باختيار مكتبة الفئات.

  4. في المربع اسم قم بكتابة اسماً مناسباً لمكتبة الفئات مثل MySecondVisualizer.

  5. انقر فوق موافق.

و الآن يمكنك إضافة عنصر مصور مرئي إليه:

لإضافة عنصر مصور مرئي

  1. في مستكشف الحلول انقر بزر الماوس الأيمن فوق MySecondVisualizer.

  2. على القائمة المختصرة قم باختيار إضافة ثم انقر فوق عنصر جديد .

  3. في مربع الحوار إضافة عنصر جديد ضمن قوالب , القوالب المثبتة ‏‫Visual Studio قم بتحديد مصحح أخطاء مصور مرئي.

  4. في المربع اسم قم بكتابة اسماً مناسباً مثل SecondVisualizer.cs.

  5. انقر فوق إضافة.

هذا هو كل ما ينبغي القيام به, قم بالنظر إلى ملف SecondVisualizer.cs و عرض التعليمات البرمجية التي تمت إضافتها بواسطة القالب و الانتقال إلى الأمام ثم حاول تجربة ذلك من خلال التعليمات البرمجية, و الآن بعد أن كنت قد تعرفت على الأساسيات أنت في طريقك لإنشاء مصورين مرئيين أكثر تعقيداً و إفادة.

راجع أيضًا:

المهام

كيفية القيام بما يلي: تثبيت مصور مرئي

المبادئ

هندسة مصور مرئي

موارد أخرى

مرئيات