عنصر <remove> لـ <listeners> لـ <source>

مقالة
11/01/2010

إزالة وحدة إصغاء من المجموعة Listeners لمصدر تتبع.

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

<remove name="listenerName" />

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

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

السمات

السمة	الوصف
name	سمة مطلوبة. اسم وحدة الإصغاء لإزالته من محموعة Listeners.

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

لا يوجد.

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

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

ملاحظات

يقوم عنصر <remove> بإزالة وحدة إصغاء محددة من المجموعة Listeners لمصدر التتبع.

يمكنك إزالة عنصر من المجموعة Listeners لمصدر التتبع برمجياً عن طريق استدعاء أسلوب Remove على خاصية Listeners في المثيل TraceSource.

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

مثال

يظهر المثال التالي كيفية استخدام عنصر <remove> قبل استخدام العنصر <add> لإضافة وحدات إصغاء console للمجموعة Listeners لمصدر التتبع TraceSourceApp.

<configuration>
  <system.diagnostics>
    <sources>
      <source name="TraceSourceApp" switchName="sourceSwitch" 
         switchType="System.Diagnostics.SourceSwitch" >
         <listeners>
           <remove name="Default"/>
           <add name="console" 
             type="System.Diagnostics.ConsoleTraceListener" />
         </listeners>
      </source>
    </sources>
  </system.diagnostics>
</configuration>