عنصر < listeners> ل <source>

إضافة أو إزالة listeners في مجموعة Listeners ل TraceSource. listener يوجه إخراج التتبع إلى هدف مناسب مثل السجل , نافذة , ملف نصي.

عنصر <configuration>
  عنصر <system.diagnostics>
    عنصر <sources>
      عنصر <source>
        عنصر < listeners> ل <source>

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

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

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

السمات

لا يوجد.

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

العنصر	الوصف
عنصر <add> لـ <listeners> لـ <source>	يضيف وحدة إصغاء إلى المجموعة Listeners.
عنصر <remove> لـ <listeners> لـ <source>	يزيل listener من المجموعة Listeners.
عنصر <clear > ل< listeners> ل <source>	يمسح المجموعةListeners لمصدر التتبع.

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

العنصر	الوصف
configuration	العنصر الجذري في كل ملف تكوين المستخدم من قبل وقت تشغيل اللغة العامة وتطبيقات .NET Framework.
system.diagnostics	تعيّن trace listeners التي تقوم بتجميع وتخزين و توجيه الرسائل و المستوى الذي يتم فيه تعيين المبدّل.
sources	يحتوي على مصادر التتبع التي تبدأ رسائل التتبع.
source	يحدّد مصدر التتبع الذي يبدأ رسائل التتبع.

ملاحظات

ملف التكوين

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

مثال

يظهر المثال التالي كيفية استخدام العنصر <listeners> لإضافة listener تتبع وحدة التحكم إلى المصدر mySource و إزالة listener التتبع الإفتراضي.

<configuration>
  <system.diagnostics>
    <sources>
      <source name="mySource" switchName="sourceSwitch" 
        switchType="System.Diagnostics.SourceSwitch">
        <listeners>
          <add name="console" 
            type="System.Diagnostics.ConsoleTraceListener">
            <filter type="System.Diagnostics.EventTypeFilter" 
              initializeData="Error"/>
          </add>
          <remove name="Default"/>
        </listeners>
      </source>
    </sources>
    <switches>
      <add name="sourceSwitch" value="Warning"/>
    </switches>
  </system.diagnostics>
</configuration>

راجع أيضًا:

المرجع

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

TraceListener

المبادئ

تتبع Listeners