مشاركة عبر

عنصر تتبع (مخطط إعدادات ASP.NET)

  • مقالة

تكوين ASP.NET تعليمات خدمة التتبع البرمجية التي تتحكم في كيفية تجميع وتخزين وعرض نتائج التتبع.

عنصر تكوين (مخطط إعدادات عام)
  النظام.ويب عنصر (مخطط إعدادات ASP.NET)
    عنصر تتبع (مخطط إعدادات ASP.NET)

<trace 
   enabled="true|false"
   localOnly="true|false"
   pageOutput="true|false"
   requestLimit="integer" 
   mostRecent="true|false"
   writeToDiagnosticsTrace="true|false"
   traceMode="SortByTime|SortByCategory"
/>

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

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

السمات

السمة

الوصف

enabled

سمة Boolean اختيارية.

تحديد ما إذا كان قد تم تمكين التتبع لأحد التطبيقات. يجب تمكين التتبع من أجل استخدام العارض Trace.axd. تتم إضافة العارض Trace.axd بشكل افتراضيhttpHandlersللعنصر.

يكون الإعداد الافتراضي هو false.

localOnly

سمة Boolean اختيارية.

تحديد ما إذا كان عارض التتبع (Trace.axd) متوفر فقط على خادم الويب المضيف. إذا كان false، يتوفر عارض التتبع من أي كمبيوتر. تتم إضافة العارض Trace.axd بشكل افتراضيhttpHandlersللعنصر.

يكون الإعداد الافتراضي هو true.

mostRecent

سمة Boolean اختيارية.

تحديد ما إذا كان سيتم عرض أحدث إخراج للتتبع من مستوى التطبيق بالإضافة إلى بيانات التتبع القديمة التي تتجاوز الحدود المشار إليها بواسطة requestLimitيتم تجاهلها. إذا كان false, يتم عرض بيانات التتبع لطلبات حتى requestLimitالوصول إلى السمة.

هذه السمة الجديد في ‏‫NET Framework. الإصدار 2.0.

يكون الإعداد الافتراضي هو false.

pageOutput

سمة Boolean اختيارية.

تحديد ما إذا كان يتم تقديم إخراج التتبع في نهاية كل الصفحة. اذا كانfalseيمكن الوصول لنتيجة التتبع فقط من خلال أداة التتبع.

يكون الإعداد الافتراضي هو false.

requestLimit

سمة Int32 اختيارية.

تعيّن عدد طلبات التتبع لتخزينها في الخادم. إذا وصلت إلى الحد الأقصى mostRecentو كانت السمةfalse, تلقائياً يتم تعطيل تتبع.

حد الطلب الأقصى هو 10,000. إذا تم تحديد قيمة أكبر من 10,000 فإنه يتم بصمت تقريبها إلى 10.000 بواسطة ASP.NET.

يكون الإعداد الافتراضي هو 10.

traceMode

سمة TraceDisplayMode اختيارية.

تحدد ترتيب عرض معلومات التتبع.

traceMode يمكن أن تكون هذه السمة إحدى القيم الممكنة التالية.

Valueالوصف
SortByCategory تحديد عرض معلومات التتبع أبجدياً حسب الفئة المعرفة من قبل المستخدم.
SortByTime تحديد عرض معلومات التتبع بالترتيب الذي تمت به معالجة معلومات التتبع.

يكون الإعداد الافتراضي هو SortByTime.

writeToDiagnosticsTrace

سمة Boolean اختيارية.

تعيّن فيما إذا كان يتم إعادة توجيه رسائل تتبع ASP.NET إلى System.Diagnosticsالبنية الأساسية للتتبع لأي مستمع مسجل لعرض Traceالرسائل. للحصول على معلومات أكثر، راجع عنصر التتبع لـ نظام.التشخيص .

هذه السمة الجديد في ‏‫NET Framework. الإصدار 2.0.

القيمة الافتراضية هي false.

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

لا يوجد.

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

العنصر

الوصف

configuration

عنصر الجذري المطلوب في كل ملف تكوين مستخدم من قبل وقت تشغيل اللغة العامة وتطبيقات .NET Framework.

system.web

يحدد العنصر الجذري لإعدادات تكوين ASP.NET في ملف تكوين ويحتوي على عناصر تكوين التي تقوم بتكوين تطبيقات ASP.NET على ويب وتتحكم بسلوكيات التطبيقات

ملاحظات

عند تمكين التتبع يقوم كل طلب الصفحة بإنشاء رسائل تتبع يمكن إلحاقها بمخرجات الصفحة أو تخزينها في سجل تتبع التطبيق. يمكنك استخدام عارض التتبع ASP.NET (Trace.axd) لعرض محتويات سجل التتبع. تتم إضافة Trace.axd بشكل افتراضيhttpHandlersللعنصر.

ملاحظةملاحظة

بشكل عام، عليك عدم تمكين التتبع في موقع ويب نشط ، لأن ذلك يمكن عرض معلومات تكوين هامة لأي شخص يستعرض صفحات في موقع الويب.التتبع معد فقط لأغراض التصحيح.إذا كانت localOnlyالسمة true، يتم عرض معلومات التتبع فقط من لطلبات localhost.بالإضافة إلى ذلك، إذا كان deployment retail=true> يتم تعيينه في ملف ويب.config يكون التتبع معطل.

يمكنك استخدام الخصائص والأساليب في Traceالفئة لطرح تجهيزات البنيات. يسمح استخدام الآلات لك بمراقبة سمة تطبيقك عن طريق تشغيل التطبيق في إعدادات واقعية. يمكنك تتبع من عزل المشكلات وإصلاح المشكلات دون إفساد أي نظام قيد تشغيل.

تحتاج إلى إعادة ترجمة تطبيقك مع تعيين علامة التتبع لكي يكون التتبع نافذ المفعول. تقوم بإجراء ذلك عن طريق إعداد compilerOptionsالسمة لـ = "/ d:TRACE" في الخط تكوين المحول البرمجي اللغة التي تريدها أن تعتمد التتبع. يشير إلى <compiler>العنصر

التكوين الافتراضي

The following default trace element is not explicitly configured in the Machine.config file or in the root Web.config file. ومع ذلك، يتم إرجاع التكوين الافتراضي بواسطة التطبيق في ‏‫NET Framework. الإصدار 2.0.

<trace 
   enabled="false" 
   localOnly="true" 
   mostRecent="false" 
   pageOutput="false" 
   requestLimit="10" 
   traceMode="SortByTime" 
   writeToDiagnosticsTrace="false" 
/>

العنصر الافتراضي التالي trace مكون في جذر ملف Web.config في الإصدار2.0 من .NET Framework .

<trace
   enabled="false"
   localOnly="true"
   pageOutput="false"
   requestLimit="10"
   traceMode="SortByTime"
/>

مثال

مثال التعليمات البرمجية التالي يوضح كيفية تعيين إعدادات تكوين التتبع.

<configuration>
  <system.web>
    <trace enabled="true" 
      pageOutput="true"
      requestLimit="15"
      mostRecent="true" />
    <system.web>
</configuration>

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

معالج مقطع التكوين

TraceSection

عضو التكوين

TraceSection

مواقع للتكوين

Machine.config

مستوى جذر ويب.config

مستوى تطبيق ويب.config

الدليل–المستوى ويب.config الفعلية أو الظاهرية

المتطلبات

الإصدار 5.0 أو أحدث من الخدمات معلومات الإنترنت لـ Microsoft (IIS)

‎.NET Framework

Microsoft Visual Studio

راجع أيضًا:

المهام

كيفية: عرض معلومات تتبع ASP.NET مع عارض تتبع

كيفية: تكوين دلائل معينة باستخدام إعدادات الموقع

كيفية: تأمين إعدادات التكوين ASP.NET

المرجع

النظام.ويب عنصر (مخطط إعدادات ASP.NET)

عنصر تكوين (مخطط إعدادات عام)

<trace>العنصر

System.Configuration

System.Web.Configuration

TraceSection

Trace

المبادئ

نظرة عامة حول تتبع ASP.NET

تسلسل هرمي ملف تكوين ASP.NET و الوراثة

تأمين تكوين ASP.NET

وحدات سيناريو التكوين ASP.NET

موارد أخرى

إعدادات التكوين العامة (ASP.NET)

إعدادات تكوين الـ ASP.NET

إدارة مواقع ويب ASP.NET

تكوين ASP.NET API