عنصر <system.diagnostics>

مقالة
11/01/2010

تعيّن trace listeners التي تقوم بتجميع وتخزين و توجيه الرسائل و المستوى الذي يتم فيه تعيين المبدّل.

عنصر <configuration>
عنصر <system.diagnostics>

<system.diagnostics> 
</system.diagnostics>

السمات والعناصر

تصف المقاطع التالية سمات، عناصر تابعة وعناصر الأصل.

السمات

لا يوجد.

العناصر التابعة

العنصر	الوصف
Assert	تحديد ما إذا كان سيتم عرض مربع الرسالة عند استدعاء الأسلوب Debug.Assert; أيضاً تقوم بتعيين اسم الملف الذي سيتم كتابة الرسائل إليه.
عدّادات الأداء	يحدد حجم الذاكرة العمومية المشتركة من قبل عدّادات الأداء.
<sharedlisteners>	يحتوي على listeners التي يمكن لأي مصدر أو عنصر تتبع الرجوع إليها. يمكن إضافة وحدات الإصغاء التي تمت تعرفتها على أنها وحدات إصغاء مشتركة إلى الموارد أو التتبعات بالإسم.
مصادر	يحدّد مصادر التتبع الذين يقومون ببدأ رسائل التتبع.
<switches>	يحتوي على مبدّلات التتبع والمستويات التي تم فيها تعيين المبدّلات.
<trace>	يحتوي على listeners التي تقوم بتجميع وتخزين و توجيه رسائل التتبع.

العناصر الأصلية

العنصر	الوصف
configuration	العنصر الجذري في كل ملف تكوين المستخدم من قبل وقت تشغيل اللغة العامة وتطبيقات .NET Framework.

مثال

يظهر المثال التالي كيفية تضمين مبدّل تتبع ووحدة إصغاء وتتبع داخل عنصر <system.diagnostics>. يتم Generalتعيين مبدّل التتبع إلى مستوى TraceLevel.Error. وحدة إصغاء التتبع myListener تنشئ ملف يسمى MyListener.log وتكتب الإخراج إلى الملف.

ملاحظة
في الإصدار 2.0 من برنامج .NET Framework، يمكنك استخدام نص لتحديد قيمة المبدّل.على سبيل المثال، يمكنك تحديد true لـ BooleanSwitch أو استخدام نص يمثل قيمة تعداد مثل Error لـ TraceSwitch.السطر <add name="myTraceSwitch" value="Error" /> يكافئ <add name="myTraceSwitch" value="1" />.

<configuration>
   <system.diagnostics>
      <switches>
         <add name="General" value="4" />
      </switches>
      <trace autoflush="true" indentsize="2">
         <listeners>
            <add name="myListener" type="System.Diagnostics.TextWriterTraceListener, System, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" initializeData="MyListener.log" traceOutputOptions="ProcessId, LogicalOperationStack, Timestamp, ThreadId, Callstack, DateTime" />
         </listeners>
      </trace>
   </system.diagnostics>
</configuration>

راجع أيضًا:

المرجع

تتبع وتصحيح مخطط إعدادات

Trace

Debug

مشاركة عبر