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

مقالة
11/01/2010

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

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

<clear/>

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

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

السمات

لا يوجد.

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

لا يوجد.

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

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

ملاحظات

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

يمكنك مسح المجموعة Listeners برمجياً عن طريق استدعاء الأسلوب Clear على الخاصية Trace.Listeners (System.Diagnostics.Trace.Listeners.Clear()).

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

ملاحظة
العنصر <clear> يزيل DefaultTraceListener من المجموعة Listeners مغيراً من سلوك الأساليب Debug.Assert, Trace.Assert, Debug.Fail، و Trace.Fail.استدعاء الأسلوب Assert أو الأسلوب Fail يؤدي إلى عرض مربع رسالة.ومع ذلك، لن يتم عرض مربع الرسالة إذا كانDefaultTraceListener ليس في المجموعة Listeners.

العنصر <clear> يزيل DefaultTraceListener من المجموعة Listeners مغيراً من سلوك الأساليب Debug.Assert, Trace.Assert, Debug.Fail، و Trace.Fail.استدعاء الأسلوب Assert أو الأسلوب Fail يؤدي إلى عرض مربع رسالة.ومع ذلك، لن يتم عرض مربع الرسالة إذا كانDefaultTraceListener ليس في المجموعة Listeners.

مثال

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

<configuration>
  <system.diagnostics>
    <trace autoflush="false" indentsize="4">
      <listeners>
        <clear/>
        <add name="console" 
          type="System.Diagnostics.ConsoleTraceListener" >
          <filter type="System.Diagnostics.EventTypeFilter" 
            initializeData="Error" />
        </add>
      </listeners>
    </trace>
  </system.diagnostics>
</configuration>