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

يضيف وحدة إصغاء إلى مجموعة Listeners لمصدر التتبع.

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

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

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

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

السمات

السمة	الوصف
type	سمة مطلوبة. تحدّد نوع وحدة الإصغاء. يجب عليك استخدام سلسلة تلبي المتطلبات المحددة في تعيين أسماء أنواع المؤهلة بالكامل.
initializeData	السمة الاختيارية السلسلة التي يتم تمريرها إلى الدالة الإنشائية الخاصة بالفئة المحدّدة. يتم طرح ConfigurationException إذا لم يكن هناك دالة إنشائية للفئة تأخذ سلسلة.
name	السمة الاختيارية تُعيّن اسم ال listener .
traceOutputOptions	السمة الاختيارية تعيّن قيمة خاصية TraceOutputOptions لوحدة الإصغاء والتتبع.
[custom attributes]	سمات إختيارية. تعين قيمة سمات خاصة بوحدة الإصغاء يتم تعريفها بواسطة الأسلوب GetSupportedAttributes لوحدة الإصغاء تلك. Delimiter عبارة عن مثال لسمة زائدة فريدة للفئة DelimitedListTraceListener.

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

العنصر	الوصف
عنصر <filter> لـ <add> لـ <listeners> لـ <source>	يضيف عامل تصفية إلى وحدة إصغاء في المجموعة Listeners للتبع.

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

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

ملاحظات

فئات الإصغاء التي تأتي مع .NET Framework تنحدر من فئة TraceListener.

إذا لم تقم بتعيين السمة nameلوحدة الإصغاء والتتبع فإنه يتم تعين سلسلة فارغة ("") لخاصية Name لوحدة الإصغاء والتتبع بشكل إفتراضي. إذا كان للتطبيق الخاص بك وحدة إصغاء واحدة فقط يمكنك إضافته دون تحديد اسم ويمكنك إزالته عن طريق تحديد سلسلة فارغة للاسم. مع ذلك، إذا كان للتطبيق الخاص بك أكثر من وحدة إصغاء فيجب عليك تحديد أسماء فريدة لكل وحدة إصغاء وتتبع وذلك يسمح لك بتعريف وإدارة وحدات إصغاء وتتبع فردية في المجموعة TraceSource.Listeners.

ملاحظة
إضافة أكثر من listener تتبع من نفس النوع وبنفس الاسم يؤدي إلى إضافة listener تتبع واحد فقط من هذا النوع و الاسم إلى المجموعة Listeners .ومع ذلك، يمكنك إضافة - عدة listeners متطابقة - برمجياً إلى المجموعة Listeners .

قيمة سمة initializeData تعتمد على نوع وحدة الإصغاء الذي تقوم بانشائه. ليست كل وحدت إصغاء التتبع تتطلب منك تحديد initializeData.

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

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

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

ملف التكوين

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

مثال

يظهر المثال التالي كيفية استخدام العناصر <add> لإضافة وحدات الإصغاء console و 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