مشاركة عبر

عنصر <listeners> لـ <trace>

  • مقالة

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

عنصر <configuration>
  عنصر <system.diagnostics>
    عنصر <trace>
      عنصر <listeners> لـ <trace>

<listeners> 
  <add>...</add>
  <clear/>
  <remove ... />
</listeners>

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

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

السمات

لا يوجد.

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

العنصر

الوصف

عنصر <add> ل <listeners> ل <trace>

يضيف وحدة إصغاء إلى المجموعة Listeners.

عنصر <clear > ل< listeners> ل <trace>

تمسح المجموعة Listeners للتتبع.

عنصر <add> ل <listeners> ل <trace>

يزيل listener من المجموعة Listeners.

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

العنصر

الوصف

configuration

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

system.diagnostics

تحدّد جذر العنصر لمقطع التكوين ASP.NET .

trace

يحتوي على listeners التي تقوم بتجميع وتخزين و توجيه رسائل التتبع.

ملاحظات

الفئات Debug و Trace تشارك نفس المجموعة listeners. إذا قمت بإضافة كائن وحدة إصغاء إلى المجموعة في واحد من هذه الفئات، الفئة الأخرى تستخدم نفس وحدة الإصغاء. فئات الإصغاء التي تأتي مع .NET Framework تنحدر من فئة TraceListener.

ملف التكوين

يمكن استخدام هذا العنصر في ملف تكوين التطبيق أو ملف تكوين الجهاز . (Machine.config).

مثال

المثال التالي يوضح كيفية استخدام عناصر <listeners> لإضافة وحدات إصغاء MyListener و MyEventListener إلى المجموعة listeners. يقوم MyListener بإنشاء ملف يسمى MyListener.log ثم يكتب المخرج إلى الملف. يقوم MyEventListener بإنشاء إدخال في سجل الحدث.

<configuration>
  <system.diagnostics>
    <trace autoflush="true" indentsize="0">
      <listeners>
        <add name="myListener" 
          type="System.Diagnostics.TextWriterTraceListener, 
            system, version=1.0.3300.0, Culture=neutral, 
            PublicKeyToken=b77a5c561934e089" 
          initializeData="c:\myListener.log" />
        <add name="MyEventListener"
          type="System.Diagnostics.EventLogTraceListener, 
            system, version=1.0.3300.0, Culture=neutral, 
            PublicKeyToken=b77a5c561934e089"
          initializeData="MyConfigEventLog"/>
      </listeners>
    </trace>
  </system.diagnostics>
</configuration>

راجع أيضًا:

المرجع

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

TraceListener