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

مقالة
11/01/2010

يمسح المجموعةListeners لمصدر التتبع.

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

<clear/>

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

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

السمات

لا يوجد.

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

لا يوجد.

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

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

ملاحظات

العنصر <clear> يزيل كل listeners من المجموعة Listeners لمصدر تتبع بما في ذلك DefaultTraceListener. يمكنك استخدام العنصر <clear> قبل استخدام العنصر <add> للتأكد من عدم وجود listeners أخرى نشطة في المجموعة.

ملف التكوين

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

مثال

المثال التالي يوضح كيفية استخدام العنصر <clear> قبل استخدام العناصر <add> لإضافة listeners console و textListener إلى المجموعة Listeners لمصدر التتبع TraceSourceApp.

<configuration>
  <system.diagnostics>
    <sources>
       <source name="TraceSourceApp" switchName="sourceSwitch" 
         switchType="System.Diagnostics.SourceSwitch">
        <listeners>
          <clear/>
          <add name="console" 
            type="System.Diagnostics.ConsoleTraceListener"/>
          <add name="textListener"/>
        </listeners>
      </source>
    </sources>
    <sharedListeners>
      <add name="textListener" 
        type="System.Diagnostics.TextWriterTraceListener" 
        initializeData="myListener.log"/>
    </sharedListeners>
    <switches>
      <add name="sourceSwitch" value="Warning"/>
    </switches>
  </system.diagnostics>
</configuration>