عنصر <filter> ل <add> لـ <sharedlisteners>

مقالة
11/01/2010

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

عنصر <configuration>
  عنصر <system.diagnostics>
    عنصر <sharedListeners>
      عنصر <add> لـ <sharedListeners>
        عنصر <filter> ل <add> لـ <sharedlisteners>

<filter type="System.Diagnostics.EventTypeFilter" 
  initializeData="Warning" />

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

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

السمات

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

كتابة

سمة مطلوبة.

تحدّد نوع ال filter. يمكنك استخدام الاسم الكامل فقط من النوع (في التنسيق للخاصية Type.FullName ) ، أو يمكنك استخدام إسم نوع مؤهل بشكل كامل بما في ذلك معلومات التجميع (في التنسيق للخاصية Type.AssemblyQualifiedName). للحصول على معلومات حول إنشاء إسم نوع مؤهل بشكل كامل , راجع تعيين أسماء أنواع المؤهلة بالكامل.

initializeData

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

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

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

لا يوجد.

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

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

ملاحظات

إذا تم تعريف وحدة إصغاء في عنصر <add> للعنصر <sharedListeners> , يجب تعريف عامل التصفية لوحدة الإصغاء في عنصر <filter> الذي هو عنصر فرعي ل <add> .

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

مثال

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

<configuration>
  <system.diagnostics>
    <sources>
      <source name="myTraceSource" >
        <listeners>
          <add name="console" />
          <remove name="Default" />
        </listeners>
      </source>
    </sources>
    <sharedListeners>
      <add name="console" 
        type="System.Diagnostics.ConsoleTraceListener" >
        <filter type="System.Diagnostics.EventTypeFilter" 
          initializeData="Error" />
      </add>
    </sharedListeners>
  </system.diagnostics>
</configuration>