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

مقالة
11/01/2010

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

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

<filter 
  type="traceFilterClassName" 
  initializeData="data" />

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

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

السمات

السمة	الوصف
type	سمة مطلوبة. تعيّن نوع عامل التصفية الذي يجب أن يرث من الفئة TraceFilter. يمكنك إستخدام إسم مساحة الإسم المؤهل الذي يتوافق مع نوع السمة FullName أو يمكنك استخدام اسم النوع المؤهل بالكامل بما في ذلك معلومات التجميع و التي تتوافق مع السمة AssemblyQualifiedName. لمزيد من المعلومات حول أسماء النوع المؤهلة بالكامل , راجع تعيين أسماء أنواع المؤهلة بالكامل.
initializeData	السمة الاختيارية السلسلة التي يتم تمريرها إلى الدالة الإنشائية الخاصة بفئة عامل التصفية المحدّدة.

type

سمة مطلوبة.

تعيّن نوع عامل التصفية الذي يجب أن يرث من الفئة TraceFilter. يمكنك إستخدام إسم مساحة الإسم المؤهل الذي يتوافق مع نوع السمة FullName أو يمكنك استخدام اسم النوع المؤهل بالكامل بما في ذلك معلومات التجميع و التي تتوافق مع السمة AssemblyQualifiedName. لمزيد من المعلومات حول أسماء النوع المؤهلة بالكامل , راجع تعيين أسماء أنواع المؤهلة بالكامل.

initializeData

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

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

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

لا يوجد.

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

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

ملاحظات

يجب أن يتم إحتواء العنصر <filter> في عنصر <add> لوحدة إصغاء التتبع التي تحدد نوع وحدة الإصغاء و ليس فقط إسم وحدة الإصغاء المعرفة في عنصر <sharedListeners>. إذا تم تعريف وحدة الإصغاء في عنصر <sharedListeners>، يجب تعريف عامل تصفية وحدة الإصغاء في ذلك العنصر.

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

مثال

يظهر المثال التالي كيفية استخدام العنصر <filter> لإضافة عامل تصفية إلى وحدة الإصغاء console في المجموعة Listeners للتتبع مع تحديد مستوى حدث عامل التصفية ك Error.

<configuration>
  <system.diagnostics>
    <trace autoflush="false" indentsize="4">
      <listeners>
        <add name="console" 
          type="System.Diagnostics.ConsoleTraceListener" >
          <filter type="System.Diagnostics.EventTypeFilter" 
            initializeData="Error" />
        </add>
        <remove name="Default" />
      </listeners>
    </trace>
  </system.diagnostics>
</configuration>