كيفية القيام بما يلي: تكوين تتبع رموز التبديل

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

Your switches are configured using the .config ملف. و للحصول على تطبيق ويب , هذا هو ملف Web.config المقترن بالمشروع. في a تطبيقات Windows, this ملف هو named (اسم تطبيق).exe.config. في a deployed تطبيق, this ملف must reside في the same مجلد كـ the تنفيذي.

When your تطبيق executes the تعليمات برمجية that creates an مثيل of a تبديل for the أول الوقت, it checks the ملف تكوين for trace-المستوى معلومات حول the named تبديل. The تتبع النظام examines the ملف تكوين فقط once for أي particular تبديل — the أول الوقت your تطبيق creates the تبديل.

في a deployed تطبيق, you تمكين trace تعليمات برمجية بواسطة reconfiguring تبديل الكائنات when your تطبيق ليس تشغيل. Typically this involves turning the تبديل الكائنات تشغيل و إيقاف أو بواسطة changing the تتبع levels, و then restarting your تطبيق.

When you إنشاء an مثيل of a تبديل, you also يهيّئ it بواسطة specifying الثاني الوسيطات: a displayName وسيطة و a وصف وسيطة. The displayName وسيطة of the الدالة الإنشائية sets the Switch.DisplayName خاصية of the Switch فئة مثيل. The displayName هو the اسم that هو used إلى تكوين the تبديل في the .config ملف, و the وصف وسيطة should return a brief وصف of the تبديل و what رسائل it عناصر التحكم.

في addition إلى specifying the اسم of a تبديل إلى تكوين, you must also specify a القيمة for the تبديل. This القيمة هو an عدد صحيح. For BooleanSwitch, a القيمة of 0 corresponds إلى إيقاف, و أي nonzero القيمة corresponds إلى تشغيل. For TraceSwitch, 0,1,2,3, و 4 correspond إيقاف, خطأ, تحذير, Info, و Verbose, respectively. أي رقم أكبر من 4 هو treated كـ Verbose, و أي رقم أصغر من zero هو treated كـ إيقاف.

ملاحظة
في الإصدار 2.0 من برنامج .NET Framework، يمكنك استخدام نص لتحديد قيمة المبدّل.For مثال, true for a BooleanSwitch أو the نص representing an قائمة تعداد القيمة such كـ Error for a TraceSwitch. السطر <add name="myTraceSwitch" value="Error" /> يكافئ <add name="myTraceSwitch" value="1" />.

في ترتيب for إنهاء users إلى be able إلى تكوين an تطبيق's trace switches, you must provide مُفصل documentation تشغيل the switches في your تطبيق. You should detail which switches عنصر تحكم what و how إلى turn them تشغيل و إيقاف. You should also provide your إنهاء مستخدم مع a .config ملف that has appropriate تعليمات في the تعليقات.

إلى إنشاء و تكوين trace switches

1. إنشاء your switches في تعليمات برمجية. For المزيد معلومات, see Creating و Initializing Trace Switches.

2. إذا كان مشروع الخاص بك لا يحتوي على ملف تكوين (app.config أو ويب.config)، ثم من القائمة مشروع ، حدد العنصر "إضافة جديد" .

   • Visual Basic: في إضافة عنصر جديد? صندوق حوار، اختر من ملف تكوين تطبيق.

     The تطبيق ملف تكوين هو تاريخ الإنشاء و opened. This هو an XML مستند whose جذر عنصر هو <configuration>.

   • Visual C#‎: في the إضافة عنصر جديد? حوار صندوق, اختيار ملف XML. اسم this ملف app.config. في محرر XML، بعد إعلان XML، إضافة XML التالية:

     <configuration>
     </configuration>
     

     متى يتم التحويل البرمجي للمشروع، app.config ملف نسخها إلى المجلد الخارج مشروع وهو applicationname الذي تمت إعادة تسميته . exe.config.

3. بعد <configuration> علامة ولكن قبل </configuration> علامة، إضافة XML المناسبة لتكوين رموز التبديل الخاصة بك. تبين الأمثلة التالية BooleanSwitch مع DisplayName خاصية DataMessageSwitchو TraceSwitch مع DisplayName خاصية TraceLevelSwitch.

   <system.diagnostics>
      <switches>
         <add name="DataMessagesSwitch" value="0" />
         <add name="TraceLevelSwitch" value="0" />
      </switches>
   </system.diagnostics>
   

   في هذا تكوين، تقوم كل من مفاتيح التبديل إيقاف.

4. إذا كنت بحاجة إلى تشغيل BooleanSwitch ، مثل DataMessagesSwitchهو موضح في المثال السابق، تغيير القيمة إلى أي عدد صحيح بدلاً من 0.

5. إذا كنت بحاجة إلى تشغيل TraceSwitch ، مثل TraceLevelSwitchهو موضح في المثال السابق، تغيير القيمة لإعداد المستوى المناسبة (من 1 إلى 4).

6. قم بإضافة تعليقات إلى الملف.config حتى مستخدم النهائي على فهم واضح للقيم التي تقوم بتغيير تكوين رموز التبديل بشكل مناسب.

   يوضح المثال التالي كيفية النهائية تعليمات برمجية، بما في ذلك التعليقات، قد يبدو:

   <system.diagnostics>
      <switches>
         <!-- This switch controls data messages. In order to receive data 
            trace messages, change value="0" to value="1" -->
         <add name="DataMessagesSwitch" value="0" />
         <!-- This switch controls general messages. In order to 
            receive general trace messages change the value to the 
            appropriate level. "1" gives error messages, "2" gives errors 
            and warnings, "3" gives more detailed error information, and 
            "4" gives verbose trace information -->
         <add name="TraceLevelSwitch" value="0" />
      </switches>
   </system.diagnostics>
   

راجع أيضًا:

المهام

كيفية القيام بما يلي: قم بإضافة بيانات التتبع إلى تعليمات برمجية للتطبيق

المرجع

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

المبادئ

مقدمة إلى أجهزة و تتبع

تتبع رموز التبديل

موارد أخرى

تتبع و إدارة تطبيقات