عنصر <sharedListeners>

يحتوي على listeners التي يمكن لأي مصدر أو عنصر تتبع الرجوع إليها. وحدات الإصغاء هذه لا تتلقى أي تتبعات إفتراضياً , و ليس من الممكن الحصول على وحدات الإصغاء هذه في وقت التشغيل. يمكن إضافة وحدات الإصغاء التي تمت تعرفتها على أنها وحدات إصغاء مشتركة إلى الموارد أو التتبعات بالإسم.

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

<sharedListeners> 
  <add>...</add>
</sharedListeners>

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

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

السمات

لا يوجد.

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

العنصر	الوصف
عنصر <add> ل <listeners> ل <trace>	يضيف وحدة إصغاء إلى المجموعة sharedListeners.

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

العنصر	الوصف
Configuration	العنصر الجذري في كل ملف تكوين المستخدم من قبل وقت تشغيل اللغة العامة وتطبيقات .NET Framework.
system.diagnostics	تحدّد جذر العنصر لمقطع التكوين ASP.NET .

ملاحظات

إضافة وحدة إصغاء إلى مجموعة وحدات إصغاء مشتركة لا يجعلها وحدات إصغاء نشطة. مازال يجب أن يتم إضافته إلى مصدر تتبع أو تتبع عن طريق إضافته إلى المجموعة Listeners لعنصر التتبع ذلك. فئات وحدة الإصغاء NET Framework. مشتقة من الفئة TraceListener.

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

مثال

المثال التالي يوضح كيفية استخدام العنصر <sharedListeners> لإضافة وحدة الإصغاء console إلى المجموعة Listeners لكل من الفئات TraceSource و Trace. وحدة إصغاء التتبع لوحدة التحكم تكتب معلومات تتبع إلى وحدة التحكم من خلال الاستدعاءات إلى TraceSource أو Trace.

<configuration>
  <system.diagnostics>
    <sharedListeners>
      <add name="console" type="System.Diagnostics.ConsoleTraceListener" >
        <filter type="System.Diagnostics.EventTypeFilter"
          initializeData="Warning" />
      </add>
    </sharedListeners>
    <sources>
      <source name="mySource" switchName="sourceSwitch"  >
        <listeners>
          <add name="console" />
        </listeners>
      </source>
    </sources>
    <switches>
      <add name="sourceSwitch" value="Verbose"/>
    </switches>
    <trace>
      <listeners>
        <add name="console" />
      </listeners>
    </trace>
  </system.diagnostics>
</configuration></system.diagnostics> 

راجع أيضًا:

المرجع

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

TraceListener

المبادئ

تتبع Listeners