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

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

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

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

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

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

السمات

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

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

لا يوجد.

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

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

ملاحظات

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

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

مثال

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

<configuration>
  <system.diagnostics>
    <sources>
      <source name="myTraceSource" switchName="SourceSwitch" 
        switchType="System.Diagnostics.SourceSwitch"  >
        <listeners>
          <add name="console" 
            type="System.Diagnostics.ConsoleTraceListener" >
            <filter type="System.Diagnostics.EventTypeFilter" 
              initializeData="Error" />
          </add>
          <remove name="Default" />
        </listeners>
      </source>
    </sources>
    <switches>
      <add name="SourceSwitch" value="Warning" />
    </switches>
  </system.diagnostics>
</configuration>

راجع أيضًا:

المرجع

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

TraceSource

TraceListener

TraceListener.Filter

TraceFilter