عنصر <add> ل <listeners> ل <trace>

مقالة
11/01/2010

يضيف listener للمجموعة listeners .

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

<add name="name" 
     type="trace listener class name, Version, Culture, PublicKeyToken"
     initializeData="data"/>

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

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

السمات

السمة	الوصف
كتابة	سمة مطلوبة. تحدّد نوع وحدة الإصغاء. يجب عليك استخدام السلسلة التي تلبي المتطلبات المحدّدة في Specifying Fully Qualified Type Names.
initializeData	السمة الاختيارية السلسلة التي يتم تمريرها إلى الدالة الإنشائية الخاصة بالفئة المحدّدة.
اسم	السمة الاختيارية تُعيّن اسم ال listener .

كتابة

سمة مطلوبة.

تحدّد نوع وحدة الإصغاء. يجب عليك استخدام السلسلة التي تلبي المتطلبات المحدّدة في Specifying Fully Qualified Type Names.

initializeData

السمة الاختيارية

السلسلة التي يتم تمريرها إلى الدالة الإنشائية الخاصة بالفئة المحدّدة.

اسم

السمة الاختيارية

تُعيّن اسم ال listener .

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

لا يوجد.

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

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

ملاحظات

الفئات Debug و Trace تشارك نفس المجموعة listeners. إذا قمت بإضافة كائن وحدة إصغاء إلى المجموعة في واحد من هذه الفئات، الفئة الأخرى تستخدم نفس وحدة الإصغاء. فئات listener تنحدر من فئة TraceListener.

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

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

قيمة السمة initializeData تعتمد على نوع listener الذي تقوم بانشائه. ليست كل listeners التتبع تتطلب منك تحديد initializeData.

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

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

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

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

مثال

المثال التالي يوضح كيفية استخدام عناصر <add> لإضافة ال listeners MyListener و MyEventListener إلى المجموعة listeners . يقوم MyListener بإنشاء ملف يسمى MyListener.log ثم يكتب المخرج إلى الملف. يقوم MyEventListener بإنشاء إدخال في سجل الحدث.

<configuration>
   <system.diagnostics>
      <trace autoflush="true" indentsize="0">
         <listeners>
            <add name="myListener" type="System.Diagnostics.TextWriterTraceListener, system, version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" initializeData="c:\myListener.log" />
            <add name="MyEventListener"
                 type="System.Diagnostics.EventLogTraceListener, system, version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"                 initializeData="MyConfigEventLog"/>
            <add name="configConsoleListener"
                 type="System.Diagnostics.ConsoleTraceListener, system, version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>
         </listeners>
      </trace>
   </system.diagnostics>
</configuration>