نظرة عامة حول تسجيل في MSBuild
MSBuildloggers توفر طريقة لتخصيص التقرير عن أحداث الإنشاء، والرسائل، تحذيرات، وأخطاء. يمكن عرض المعلومات في نافذة وحدة التحكم loggers أو الكتابة إلى XML أو ملف نصي أو إدخال بنية البيانات إلى قاعدة بيانات.
Loggers MSBuild
مسجل هو المستخدمة للمعلومات الخاصة بترحيل من إنشاء أحداث والرسائل والتحذيرات والأخطاء إلى يسجل التي هو قراءتها وتفسيرها بسهولة. تتم كتابة المنطق المسجل في نوع مدار الذي يطبق في ILoggerالواجهة.
مسجل وحدة التحكم الافتراضي MSBuild
عند تشغيل MSBuild.exe من سطر الأوامر، MSBuildيستخدم مسجل وحدة التحكم الافتراضي إلى عرض بنية معلومات حدث في إطار وحدة التحكم. يمكنك cusإلىmize المستوى التفاصيل التي تريدها في المسجل إلى التقرير باستخدام /verbosityالتبديل في سطر الأوامر.
المسجل وحدة التحكم الافتراضية يقبل معلمات إضافى يمكن تعديل الإخراج إلى نافذة وحدة التحكم. يتم تحديد هذه المعلمات مع /consoleloggerparametersتبديل على سطر الأوامر.
إذا كنت تستخدم مسجل مخصص، قد تحتاج إلى إخفاء المعلومات المعروضة من المسجل وحدة التحكم الافتراضي. استخدام /noconsoleloggerالتبديل في سطر الأوامر إلى تعطيل وحدة التحكم الافتراضي المسجل.
ملف MSBuild مسجل
MSBuildيشتمل على مسجل ملف تسجيل بنية معلومات حدث إلى الملف. لتشغيل ملف يسجل ger، استخدم مفتاح التبديل التالي في سطر الأوامر، الموقع MyLog.logهو الملف الموقع تريد تخزين يسجل المعلومات.
/l:FileLogger,Microsoft.Build.Engine;logfile=MyLog.log
في إجمالي, the ملف logger also accepts الرابع معلمات. وهي:
Logfile: A مطلوب معلمة that specifies the ملف في which إلى store the يسجل معلومات.
Append: An اختياري boolean معلمة that indicates whether أو not إلى append the يسجل إلى the specified ملف: true إلى إضافة the يسجل إلى the نص already موجود في the ملف; false إلى الكتابة فوق the المحتويات of the ملف. يكون الإعداد الافتراضي هو false.
Verbosity: معلمة اختيارية يتجاوز الإعداد العمومي الحدين هذا ملف المسجل فقط. This enables you إلى يسجل إلى several loggers, each مع a different اطناب.
Encoding: An اختياري معلمة that specifies the ترميز for the ملف, for مثال, UTF-8.
Multiple معلمات are separated مع semicolons (;). على سبيل المثال، ما يلي سطر الأوامر تسجيل معلومات الحدث البنية إلى الملف MyLog.log، وإلحاق بالسجل للنص في الملف، مع diagnosticالحدين، ومع UTF-8ترميز.
MSBuild MyProj.proj /l:FileLogger,Microsoft.Build.Engine;logfile=MyLog.log append=true;verbosity=diagnostic;encoding=utf-8
Specifying a Logger
إذا كنت ترغب في استخدام مسجل خلاف المسجل وحدة التحكم الافتراضي أثناء بناء، حدد المسجل المخصص باستخدام /loggerالتبديل سطر الأوامر. For المزيد مُفصل معلومات تشغيل MSBuild الأمر خط switches, see مرجع سطر الأوامر MSBuild.
Writing a Logger
المنطق المسجل هو المكتوبة في تعليمات برمجية المدارة والمحددة في MSBuildاستخدام سطر الأوامر /loggerتبديل.
يمكنك كتابة المسجل الخاص بك بواسطة كتابة نوع مدار الذي يطبق ILoggerواجهة. لمزيد من المعلومات، راجع بنية Loggers.
راجع أيضًا:
المبادئ
Loggفيg في بيئة Multi-Processor