عنصر <trace>

مقالة
11/01/2010

يحتوي على listeners التي تقوم بتجميع وتخزين و توجيه رسائل التتبع.

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

<trace autoflush="true|false" 
       indentsize="indent value"
       useGlobalLock="true| false"/>

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

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

السمات

السمة	الوصف
autoflush	السمة الاختيارية تحديد ما إذا كانت listeners التتبع تقوم بمسح مخزن المخرجات المؤقت تلقائياً بعد كل عملية كتابة.
indentsize	السمة الاختيارية تعيّن عدد المسافات في المسافة البادئة.
useGlobalLock	السمة الاختيارية تشير إلى ما إذا كان يجب استخدام القفل العمومي.

autoflush

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

تحديد ما إذا كانت listeners التتبع تقوم بمسح مخزن المخرجات المؤقت تلقائياً بعد كل عملية كتابة.

indentsize

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

تعيّن عدد المسافات في المسافة البادئة.

useGlobalLock

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

تشير إلى ما إذا كان يجب استخدام القفل العمومي.

سمة autoflush

Value	الوصف
false	لا يمسح مخزن المخرجات المؤقت تلقائياً. هذا هو الإعداد الافتراضي.
true	يمسح مخزن المخرجات المؤقت تلقائياً.

سمة useGlobalLock

Value	الوصف
false	لا يستخدم القفل العمومي إذا كانت listener مؤشر ترابط آمن و إلا يتم استخدام القفل العمومي.
true	يستخدم القفل العمومي بغض النظر عن كون listener مؤشر ترابط آمن. هذا هو الإعداد الافتراضي.

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

العنصر	الوصف
<listeners>	يعيّن عنصر listener الذي يقوم بتجميع و تخزين و توجيه الرسائل.

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

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

مثال

المثال التالي يوضح كيفية استخدام العنصر <trace> لإضافة وحدة الإصغاء MyListener إلى المجموعة Listeners. MyListener تنشئ ملف باسم MyListener.log ثم تكتب الإخراج إلى الملف. يتم تعيين السمة useGlobalLock إلى false، الذي يؤدي إلى عدم إستخدام القفل العمومي إذا كانت وحدة الإصغاء هي مسار سليم. يتم تعيين السمة autoflush إلى true، والتي تؤدي إلى جعل وحدة إصغاء التتبع تكتب إلى الملف بغض النظر عن ما إذا تم إستدعاء الأسلوب Trace.Flush. يتم تعيين السمة indentsizeإلى 0 (صفر) ، الذي يجعل وحدة الإصغاء تقوم بتصفير المسافات البادئة عند إستدعاء الأسلوب Trace.Indent.

<configuration>
   <system.diagnostics>
      <trace useGlobalLock="false" 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" />
         </listeners>
      </trace>
   </system.diagnostics>
</configuration>