عنصر <source>

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

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

<source> 
  <listeners>...</listeners>
</source>

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

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

السمات

السمة	الوصف
name	السمة الاختيارية تحدّد اسم مصدر التتبع.
switchName	السمة الاختيارية تعيّن اسم مثيل مبدل التتبع في التطبيق. إذا لم يتم تعريف المبدل في عنصر <switches> , القيمة تعين مستوى المبدل.
switchType	السمة الاختيارية تحدد نوع مبدل التتبع. إذا كانت موجودة, يجب أن يكون النوع إسم فئة صالح و ليس من الممكن أن يكون سلسلة فارغة.
extraAttribute	السمة الاختيارية تعيين القيمة للسمة الخاصة بمصدر التتبع المعرفة من قبل الأسلوب GetSupportedAttributes لمصدر التتبع ذلك.

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

العنصر	الوصف
عنصر <listeners> لـ <trace>	يحتوي على وحدات إصغاء التي تقوم بتجميع وتخزين و توجيه الرسائل.

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

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

ملاحظات

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

مثال

المثال التالي يوضح كيفية إستخدام العنصر <source> لإضافة مصدر التتبع 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>

راجع أيضًا:

المرجع

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

المبادئ

تتبع مصادر

تبديل تتبع