تتبع رموز التبديل
تبديل تتبع يسمح لك إلى تمكين وتعطيل وتصفية إخراج التتبع. تصبح الكائنات الموجودة في تعليمات برمجية الخاصة بك ويمكن أن يتم تكوين خارجياً من خلال.config ملف. هناك ثلاثة أنواع من رموز تبديل تتبع المتوفرة في.NET Framework: BooleanSwitchالفئة، TraceSwitchفئة، و SourceSwitchclass. BooleanSwitchفئة يعمل مفتاح تبديل، أما تمكين أو تعطيل العديد من عبارات التتبع. TraceSwitchو SourceSwitchفئات تسمح لك إلى تمكين تبديل تتبع المستوى تتبع معينة حتى Traceأو TraceSourceتظهر الرسائل المحددة لهذا الالمستوى وكافة المستويات الأدنى. إذا قمت بتعطيل تبديل، لن تظهر الرسائل التتبع. الجميع هذه فئة عم ينحدر من الملخص ( من MustInherit) فئة التبديل، كما يجب على أية مفاتيح المطورة من قبل مستخدم.
قد يكون مفيداً لتصفية رموز تبديل تتبع معلومات. على سبيل المثال، قد تحتاج إلى مشاهدة كل رسالة التتبع في الوصول إلى بيانات وحدة نمطية?، ولكن رسائل الخطأ في باقي تطبيق فقط. في هذه الحالة، يمكنك استخدام تبديل تتبع واحد للوحدة النمطية للوصول إلى بيانات و مفتاح واحد لبقية تطبيق. باستخدام الملف.config لتكوين مفاتيح التبديل إلى الإعدادات المناسبة، يمكن التحكم بأنواع تتبع الرسالة التي تلقيتها. للمزيد من المعلومات، راجع كيفية القيام بما يلي: إنشاء ويهيّئ تبديل تتبع وكيفية القيام بما يلي: تكوين تتبع رموز التبديل.
تطبيقات موزعة بشكل عام، هو تنفيذها مع dهوabled رموز التبديل الخاصة بها، بحيث لا تحتاج إلى المستخدمين بمشاهدة العديد من رسائل التتبع متعلقة بالظهور على شاشة أو ملء ملف يسجل يتم تشغيل تطبيق. إذا كان يبرز مشكلة أثناء تنفيذ تطبيق، يمكن إيقاف تطبيق تمكين رموز التبديل وإعادة تشغيل تطبيق. ثم يتم عرض الرسائل التي تتبع.
إلى استخدام رمز تبديل يتعين عليك أولاً إنشاء كائن رمز تبديل من فئة BooleanSwitch TraceSwitch فصل دراسي أو فئة المعرفة من قبل المطور رمز تبديل. لمزيد من المعلومات حول إنشاء رموز التبديل المحددة من قبل المطور، راجع تبديل الفئة في مرجع برنامج.NET Framework. ثم تقوم بتعيين القيمة تكوين تحدد متى تبديل كائن يتم استخدام. اختبار إعداد للكائن التبديل في عدة تتبع ثم (أويصحح).
تتبع مستويات
When you استخدم TraceSwitch, there are إضافى considerations. A TraceSwitch كائن has الرابع خصائص that return منطقي قيم indicating whether the تبديل هو التعيين إلى على الأقل a particular المستوى:
Levels allow you إلى limit the المقدار of تتبع معلومات you receive إلى فقط that معلومات needed إلى solve a problem. You specify the المستوى of detail you want في your تتبع إخراج بواسطة إعداد و configuring trace switches إلى the appropriate trace المستوى. You can receive خطأ رسائل, تحذير رسائل, informational رسائل, verbose تتبع رسائل, أو لا رسالة at الجميع.
It هو entirely لأعلى إلى you إلى decide what نوع of رسالة إلى associate مع each المستوى. Typically, the محتوى of تتبع رسائل depends تشغيل what you associate مع each المستوى, but you determine the differences between levels. You might want إلى provide مُفصل descriptions of a problem at المستوى 3 (Info), for مثال, but provide فقط an خطأ مرجع رقم at المستوى 1 (خطأ). It هو entirely لأعلى إلى you إلى decide what scheme works best في your تطبيق.
تتوافق هذه الخصائص إلى قيم من 1 إلى 4 من TraceLevel بتعداد. يسرد الجدول التالي المستويات TraceLevel بتعداد و قيم الخاصة بها.
القيمة التي تم تعدادها |
القيمة عدد صحيح |
نوع الرسالة المعروضة (أو كتابتها إلى هدف إخراج محدد) |
|---|---|---|
إيقاف تشغيل |
0 |
لا يوجد |
خطأ |
1 |
فقط خطأ الرسائل |
تحذير |
2 |
رسائل تحذير و خطأ الرسائل |
معلومات |
3 |
رسائل إخبارية أو رسائل التحذير، و خطأ الرسائل |
مطول |
4 |
الرسائل الطويلة، ورسائل إخبارية، ورسائل التحذير، و رسائل الإعلام بالخطأ |
من TraceSwitch خصائص تشير إلى المستوى الحد الأقصى التتبع لرمز التبديل. أن هو، معلومات التتبع هو كتابتها للمستوى المحدد أيضا لكافة المستويات الأدنى. على سبيل المثال، إذا كان TraceInfo هو صحيحاً، ثم TraceError و TraceWarning أيضا صحيحاً لكنها أيضا قد من TraceVerbose false .
هذه الخصائص للقراءة فقط. الكائن TraceSwitchتلقائياً بتعيين عليها عندما TraceLevel خاصية هو تعيين. فعلى سبيل المثال:
Dim myTraceSwitch As New TraceSwitch("SwitchOne", "The first switch")
myTraceSwitch.Level = TraceLevel.Info
' This message box displays true, becuase setting the level to
' TraceLevel.Info sets all lower levels to true as well.
MessageBox.Show(myTraceSwitch.TraceWarning.ToString())
' This messagebox displays false.
MessageBox.Show(myTraceSwitch.TraceVerbose.ToString())
System.Diagnostics.TraceSwitch myTraceSwitch =
new System.Diagnostics.TraceSwitch("SwitchOne", "The first switch");
myTraceSwitch.Level = System.Diagnostics.TraceLevel.Info;
// This message box displays true, becuase setting the level to
// TraceLevel.Info sets all lower levels to true as well.
MessageBox.Show(myTraceSwitch.TraceWarning.ToString());
// This message box displays false.
MessageBox.Show(myTraceSwitch.TraceVerbose.ToString());
System.Diagnostics.TraceSwitch myTraceSwitch =
new System.Diagnostics.TraceSwitch("SwitchOne", "The first switch");
myTraceSwitch.set_Level(System.Diagnostics.TraceLevel.Info);
// This message box displays true, becuase setting the level to
// TraceLevel.Info sets all lower levels to true as well.
MessageBox.Show(Convert.ToString(myTraceSwitch.get_TraceWarning()));
// This message box displays false.
MessageBox.Show(Convert.ToString(myTraceSwitch.get_TraceVerbose()));}
تبديل المعرف من قبل المطور
بالإضافة إلى توفير BooleanSwitch و TraceSwitch ، يمكنك تعريف رموز التبديل الخاصة بك بواسطة الموروثة من فئة تبديل وتجاوز وظائف فئة الأساس التي مع وظائف مخصصة. لمزيد من المعلومات حول إنشاء رموز التبديل المحددة من قبل المطور، راجع تبديل الفئة في مرجع برنامج.NET Framework.
راجع أيضًا:
المهام
كيفية القيام بما يلي: قم بإضافة بيانات التتبع إلى تعليمات برمجية للتطبيق
كيفية القيام بما يلي: تكوين تتبع رموز التبديل