عنصر <sources>

مقالة
11/01/2010

يحدّد مصادر التتبع الذين يقومون ببدأ رسائل التتبع.

عنصر <configuration>
عنصر <system.diagnostics>
عنصر <sources>

<sources>
   <source>...</source>
</sources>

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

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

السمات

لا يوجد.

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

العنصر	الوصف
عنصر <source>	العنصر المطلوب. يحدّد مصدر التتبع الذي يبدأ رسائل التتبع.

عنصر <source>

العنصر المطلوب.

يحدّد مصدر التتبع الذي يبدأ رسائل التتبع.

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

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

ملاحظات

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

مثال

المثال التالي يوضح كيفية إستخدام العنصر <sources> لإضافة مصدر التتبع mySource و لتعيين المستوى للمبدّل المسمى sourceSwitch. تتم اضافة وحدة إصغاء التتبع لوحدة التحكم التي تكتب معلومات التتبع إلى وحدة التحكم.

<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>