عنصر <add> لـ <sharedListeners>

يضيف وحدة إصغاء إلى المجموعة sharedListeners. sharedListeners عبارة عن مجموعة من وحدات إصغاء ليقوم عنصر <source> أو عنصر <trace> الإشارة. بشكل افتراضي، وحدات الإصغاء في المجموعة sharedListeners لا يتم وضعها في مجموعة Listeners. يجب إضافتهم بواسطة الاسم إلى عنصر <source> أو عنصر <trace>. من غير الممكن الحصول على وحدات الإصغاء في المجموعة sharedListeners في التعليمات البرمجية في وقت التشغيل.

عنصر <configuration>
  عنصر <system.diagnostics>
    عنصر <sharedListeners>
      عنصر <add> لـ <listeners> لـ <source>

<add name="name" 
  type="TraceListenerClassName, Version, Culture, PublicKeyToken"
  initializeData="data"/>

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

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

السمات

السمة	الوصف
name	سمة مطلوبة. تعين اسم وحدة الإصغاء الغير مستخدمة لإضافة وحدة إصغاء مشتركة إلى مجموعة Listeners.
type	سمة مطلوبة. تحدّد نوع وحدة الإصغاء. يجب عليك استخدام سلسلة تلبي المتطلبات المحددة في تعيين أسماء أنواع المؤهلة بالكامل.
initializeData	السمة الاختيارية السلسلة التي يتم تمريرها إلى الدالة الإنشائية الخاصة بالفئة المحدّدة.

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

العنصر	الوصف
عنصر <filter> ل <add> لـ <sharedlisteners>	تضيف عامل تصفية لوحدة إصغاء في المجموعة sharedListeners.

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

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

ملاحظات

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

ملاحظة
عندما تستخدم سمة initializeData قد تحصل على تحذير المحول البرمجي "لم يتم التعريف عن السمة The 'initializeData' attribute is" not declared". يحدث هذا التحذير لأنه يتم التحقق من إعدادات التكوين بالمقابلة مع الفئة الأساسية المجردة TraceListener، التي لا تتعرف على السمة initializeData.بشكل عام، يمكنك تجاهل هذا التحذير لتطبيقات وحدات إصغاء التتبع التي تحتوي على دالة إنشائية تأخذ معلّمة.

يُظهر الجدول التالي وحدات إصغاء التتبع التي يتم تضمينها في .NET Framework ويصف قيمة سمات initializeData.

فئة Trace listener	قيمة السمة initializeData
ConsoleTraceListener	قيمة useErrorStream للدالة الإنشائية ConsoleTraceListener. قم بتعيين سمة initializeData لـ "true" لكتابة إخراج التتبع والتصحيح إلى دفق الخطأ القياسي، وقم بتعيينه إلى "false" للكتابة إلى دفق الإخراج القياسي.
DelimitedListTraceListener	إسم الملف الذي يقوم DelimitedListTraceListener بالكتابة إليه.
System.Diagnostics.EventLogTraceListener	اسم مصدر سجل الاحداث الموجود.
System.Diagnostics.EventSchemaTraceListener	إسم الملف الذي يقوم EventSchemaTraceListener بالكتابة إليه.
System.Diagnostics.TextWriterTraceListener	إسم الملف الذي يقوم TextWriterTraceListener بالكتابة إليه.
XmlWriterTraceListener	إسم الملف الذي يقوم XmlWriterTraceListener بالكتابة إليه.

ملف التكوين

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

مثال

المثال التالي يوضح كيفية استخدام العناصر <add> لإضافة TextWriterTraceListener textListener إلى المجموعة sharedListeners. يتم إضافة textListener بالاسم إلى مجموعة Listeners لمصدر التتبع TraceSourceApp. تقوم وحدة الإصغاء textListener بكتابة إخراج التتبع إلى الملف myListener.log.

<configuration>
  <system.diagnostics>
    <sources>
      <source name="TraceSourceApp" switchName="sourceSwitch" 
        switchType="System.Diagnostics.SourceSwitch">
        <listeners>
          <add name="console" 
            type="System.Diagnostics.ConsoleTraceListener"/>
          <add name="textListener"/>
          <remove name="Default"/>
        </listeners>
      </source>
    </sources>
    <sharedListeners>
      <add name="textListener" 
        type="System.Diagnostics.TextWriterTraceListener" 
        initializeData="myListener.log"/>
    </sharedListeners>
    <switches>
      <add name="sourceSwitch" value="Warning"/>
    </switches>
  </system.diagnostics>
</configuration> 

راجع أيضًا:

المرجع

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

TraceSource

TraceListener

المبادئ

تتبع Listeners