تتبع رسائل
عند استخدام تتبع التصحيح و TraceSource، يجب أن يكون لديك وسيلة لجمع وتسجيل رسائل التي يتم إرسالها. تلقي رسائل التتبع بواسطة رسائل . الغرض من lهوtener هو لجمع وتخزين وتوجيه رسائل التتبع. توجيه رسائل إخراج التتبع إلى هدف مناسبة، مثل السجل أو نافذة أو ملف نصي.
تتوفر رسائل إلى يصحح: التتبع و TraceSourceفئات، كل منها أن يرسل الإخراج الخاص به إلى العديد من الكائنات مصغي. هناك ثلاثة أنواع من رسائل معرف مسبقاً:
TextWriterTraceListenerإعادة توجيه الإخراج إلى مثيل TextWriterفئة أو إلى أى شىء الذي هو Streamفئة. فإنه يمكن أيضا كتابة إلى وحدة التحكم أو إلى ملف، لأن هذه هي Streamفئات.
EventLogTraceListenerبإعادة توجيه إخراج إلى يسجل. حدث
على DefaultTraceListeneremits كتابة ورسائل WriteLine إلى OutputDebugString و إلى Debugger.يسجل الأسلوب. في Visual Studio، يؤدي ذلك تصحيح الأخطاء رسائل تظهر في نافذة الإخراج. فشل رسائل Assert لفشل الإرسال أيضا OutputDebugString واجهة برمجة تطبيقات Windows و Debugger.يسجل الطريقة ويؤدي أيضا إلى عرض صندوق رسالة. هذا سلوك لأنه سلوك الافتراضي ل يصحح: والرسائل تتبع من DefaultTraceListener المضمن تلقائياً في كل Listenersمجموعة ويتم تلقائياً مُضمن وحدة الإصغاء فقط.
ConsoleTraceListenerتوجيه الإخراج تتبع أو التصحيح إلى الإخراج العادي أو دفق خطأ قياسي.
DelimitedListTraceListenerتوجيه الإخراج تتبع أو التصحيح كاتب نص، مثل كاتب لتدفق، أو دفق، مثل دفق ملف. إخراج التتبع هو بتنسيق نص محدد يستخدم محدد المحدد بواسطة Delimiterخاصية.
XmlWriterTraceListenerيوجه التتبع أو تصحيح الإخراج XML كـ-ترميز البيانات TextWriterأو إلى Stream، مثل كـ FileStream.
إذا كنت ترغب في الإصغاء بالإضافة إلى DefaultTraceListenerلتلقي التصحيحو التتبع و TraceSourceإخراج، يجب أن إضافة حتى Listenersمجموعة. للمزيد من المعلومات، راجع كيفية القيام بما يلي: قم بإنشاء و يهيّئ رسائل التتبع وكيفية القيام بما يلي: استخدام TraceSource و عوامل تصفية رسائل التتبع. إحضار أي مستمع في رسائل مجموعة نفس الرسالة من وظائف إخراج التتبع. ل مثال، هب أن تقوم بإعداد رسائل الثاني: من TextWriterTraceListener و من EventLogTraceListener. يتلقى كل وحدة إصغاء نفس الرسالة. من TextWriterTraceListener سيتم توجيه به إخراج دفق، و EventLogTraceListener سيتم توجيه به إخراج إلى يسجل الأحداث.
يلي مثال يوضح كيفية يرسل الإخراج إلى رسائل مجموعة .
' Use this example when debugging.
Debug.WriteLine("Error in Widget 42")
' Use this example when tracing.
Trace.WriteLine("Error in Widget 42")
// Use this example when debugging.
System.Diagnostics.Debug.WriteLine("Error in Widget 42");
// Use this example when tracing.
System.Diagnostics.Trace.WriteLine("Error in Widget 42");
// Use this example when debugging.
System.Diagnostics.Debug.WriteLine("Error in Widget 42");
// Use this example when tracing.
System.Diagnostics.Trace.WriteLine("Error in Widget 42");
تصحيح الأخطاء والتتبع تشترك في نفس مجموعة رسائل ، حتى إذا قمت بإضافة كائن إصغاء إلى يصحح.Listeners مجموعة في تطبيق الخاص بك، يتم إضافته إلى Trace.Listeners مجموعة كـ أيضا.
يظهر المثال التالي كيفية استخدام موزع رسائل بإرسال معلومات التتبع إلى وحدة تحكم:
Trace.Listeners.Clear()
Trace.Listeners.Add(New TextWriterTraceListener(Console.Out))
System.Diagnostics.Trace.Listeners.Clear();
System.Diagnostics.Trace.Listeners.Add(
new System.Diagnostics.TextWriterTraceListener(Console.Out));
System.Diagnostics.Trace.get_Listeners().Clear();
System.Diagnostics.Trace.get_Listeners().Add(
new System.Diagnostics.TextWriterTraceListener(Console.get_Out()));
رسائل معرف من قبل المطور
يمكنك تعريف رسائل خاصة بك بوراثة من فئة الأساس TraceListener و تجاوز الوظائف الخاصة به باستخدام وظائف المخصصة الخاصة بك. لمزيد من المعلومات حول إنشاء رسائل المعرفة من قبل المطور، راجع TraceListenerفي مرجع برنامج.NET Framework.