مشاركة عبر

خيارات سطر الأمر MSTest.exe

  • مقالة

MSTest.exe هو أمر سطر الأوامر الذي يستخدم لتشغيل الاختبارات يحتوي هذا الامر على خيارات عديدة التي يمكنك استخدمها لتخصص الاختبار الخاص بك. يمكنك استخدام هذا الخيار بالتزامن مع خيارات أخرى; في الواقع يجب عليك استخدام خيارات معينة بالتزامن مع خيارت أخرى كما هو موضح في الفصول التالية يمكنك تحديد هذه الخيارات بأي ترتيب من سطر الأوامر MSTest.exe .

لا يقوم MSTest.exe بتفسير الخيارات أو القيم التي تقوم بتحديدها له بطريقة حساسة

تقوم الجداول التالية بسرد كل الخيارات ل MSTest.exe و وصف مختصر لهم . يمكنك مشاهدة تلخيص مشابه عن طريق كتابةMSTest /h في سطر الأوامر

خيارات سطر الأوامر العامة

/testcontainer:[اسم الملف]

تحميل ملف يحتوي على اختبارات.

مثال: /testcontainer:tests.dll

للحصول على مزيد من المعلومات، راجع testcontainer.

/testmetadata:[اسم الملف]

تحميل ملف يحتوي على اختبار بيانات تعريف. للحصول على مزيد من المعلومات، راجع testmetadata.

/testlist:[مسار قائمة الاختبارات]

قم بتحديد قائمة الاختبارات كما هو محدد في ملف بيانات التعريف وذلك ليتم تشغيلها . لمزيد من المعلومات، راجع /testlist.

/category:[عامل تصفية الفئة الافتراضية:]

تحديد و تصفية أي فئات اختبار ليتم تشغيلها . لمزيد من المعلومات، راجع /category.

/test:[dest_name]

قم بـتحديد اسم اختبار ليتم تشغيله . لمزيد من المعلومات، راجع /test .

/noisolation

تشغيل الاختبارات داخل العملية MSTest.exe. يحسّن هذا الاختيار سرعة تشغيل الاختبار ولكنه يزيد الخطر على عملية MSTest.exe.

/testsettings: [اسم الملف]

قم بـاستخدام ملف إعدادات الاختبار المحدد .

مثال: /testsettings:Local.Testsettings

للحصول على مزيد من المعلومات، راجع testsettings.

/runconfig:[اسم الملف]

قم بـاستخدام ملف تكوين التشغيل المحدد.

مثال: /runconfig:localtestrun.Testrunconfig

للحصول على مزيد من المعلومات، راجع ا/runconfig.

ملاحظةملاحظة
خيار سطر الأوامر هذا يتم الاحتفاظ به للتوافق مع الإصدارات السابقة منMicrosoft Visual Studio 2010.قد تم استبدال تكوينات إعدادات الاختبار بإعدادت اختبار فيVisual Studio 2010 Ultimate.

/resultsfile:[اسم الملف]

قم بـحفظ نتائج تشغيل الاختبار الي ملف محدد.

مثال: /resultsfile:testResults.trx

لمزيد من المعلومات، راجع /resultsfile.

/unique

قم بتشغيل الاختبار فقط إذا تم العثور على تطابق فريد واحد على أي/testمحدد. لمزيد من المعلومات، راجع /unique.

/detail:[معرف الخاصية]

قم بـتحديد اسم الخاصية التي تريد إظهار القيم لها, إذا وجدت وذلك بالإضافة إلى نتيجة الاختبار. لمزيد من المعلومات، راجع /detail.

/help

يعرض رسالة الاستخدام MSTest.exe (نموذج مختصر: /? أو /h)

/nologo

لا يقوم بعرض شعار بدء التشغيل و رسالة حقوق النشر.

/usestderr

استخدم قياسي خطأ إلى إخراج خطأ inofrmation. For المزيد معلومات, see /usestderr

خيارات سطر الأوامر لنشر نتائج إختبار

لمزيد من المعلومات حول هذه الخيارات، راجع خيارات سطر الأوامر لنشر نتائج إختبار.

/publish:[اسم الملقم]

نشر النتائج إلى قاعدة بيانات مجموعة مشروع الفريق للخادم المحدد.

/publishresultsfile:[اسم الملف]

قم بتحديد اسم ملف النتائج الذي سيتم نشره. إذا لم يتم تحديد اسم ملف نتائج،قم بـاستخدام الملف الذي تم إنتاجه بواسطة التشغيل الحالي.

/publishbuild:[معرف البنية]

قم بـنشر نتائج الاختبار باستخدام معرّف البنية هذا.

/teamproject:[اسم مشروع الفريق]

قم بـتحديد اسم مشروع الفريق الذي تنتمي له البنية.

/platform:[النظام الأساسي]

قم بـتحديد النظام الأساسي للبنية التي سيتم نشر نتائج الاختبار مقابلها.

/flavor:[الصفة]

قم بـتحديد الصفة للبنية التي سيتم نشر نتائج الاختبار مقابلها.

باستخدام خيارات MSTest

تصف المقاطع التالية العديد من الخيارات لـ MSTest.exe بمزيد من التفاصيل. الخيارات التي تم استخدامها لنشر نتائج الاختبار لا يتم تضمينها هنا. لمزيد من المعلومات حول هذه الخيارات، انظر خيارات سطر الأوامر لنشر نتائج إختبار.

/testcontainer

/testcontainer:[اسم الملف]

حاوية الاختبار هي ملف يحتوي علي الاختبارات التي تريد تشغيلها . على سبيل المثال، بالنسبة للاختبارات المرتبة, حاوية الاختبار هي ملف .orderedtest و الذي يعرّف الاختبار المرتب. بالنسبة لاختبارات الوحدة هي بناء من مشروع الاختبار الذي يحتوي على ملفات مصدر اختبار الوحدة.

ملاحظة

للحصول على اختبارات وحدة, هذا هو التجميع الذي يحتوي على التعليمات البرمجية للاختبار, لا التجميع الذي يحتوي على التعليمات البرمجية للتطبيق الذي تريد اختباره. على سبيل المثال، إذا كان الحل الخاص بك يحتوي على مشروع مسمى BankAccount و مشروع اختبار مناظر مسمى BankAccountTest ،قم بتحديد /testcontainer:BankAccountTest.dll.

لاحتواء تجميع الاختبار علي الاختبارات لمشروع اختبار واحد فإن عدد حاويات الاختبار لحل يطابق عدد مشاريع الاختبار في الحل.

ملاحظة

لأن ملف بيانات تعريف الاختبار يسرد ايضا الاختبارات التي يمكنك تشغيلها، يجب عليك عدم تحديد كلا ًمن الخيارات/testcontainer و /testmetadata في سطر أوامر واحد. سيكون القيام بذلك غامضا و قد يتسبب في خطأ.

/testmetadata

/testmetadata:[اسم الملف]

يمكنك استخدام الخيار**/testmetadata** لتشغيل الاختبارات في حاويات اختبار متعددة .

يتم إنشاء ملف بيانات تعريف الاختبار للحل الخاص بك عندما تقوم بـإنشاء قوائم اختبار باستخدام نافذة محرر قائمة الاختبارات. يحتوي هذا الملف على معلومات حول كافة الاختبارات المسرودة في نافذة محرر قائمة الاختبارات. هذه هي كافة الاختبارات التي توجد في كافة مشاريع الاختبار في الحل الخاص بك .

يمكنك تغيير بيانات التعريف الاختبار فقط بإجراء التغييرات التي تنعكس في نافذة محرر قائمة الاختبارات مثل إنشاء أو حذف الاختبارات أو تغيير خصائص الاختبار.

ملاحظة

لاحتواء حاوية الاختبار على الاختبارات التي يمكنك تشغيلها يجب أن لا تحدد كلا من الخيارات /testcontainer و /testmetadata في سطر أوامر واحد. سيكون القيام بذلك غامضا و قد يتسبب في خطأ.

ملف بيانات تعريف الاختبار هو ملف XML الذي تم إنشاؤه في مجلد الحل. يتم عرض هذا الملف في "مستكشف الحلول" ضمن العقدة عناصر الحل. ملف بيانات تعريف الاختبار له الامتداد .vsmdi ويكون مقترن بنافذة محرر قائمة الاخبارات. وهذا يعني إذا نقرت نقراً مزدوجاً فوق ملف .vsmdi في "مستكشف Windows،" سيتم فتح الملفVisual Studioو المحتويات الخاصة به. يتم عرض كل الاختبارات في مشاريع اختبار الخاصة بالحل في النافذة محرر اختبار الويب.

عندما تقوم بـاستخدام الخيار**/testmetadata**، فمن المستحسن أن تقوم بـالإشارة الي اختبارات معينة لتشغيلها باستخدام الخيار**/test**أو الخيار /testlistأو كليهما.

/testlist

/testlist:[مسار قائمة الاختبارات]

The /testlist خيار هو a قائمة of tests, كـ specified في the اختبار بيانات التعريف ملف, إلى be تشغيل. لتقوم بـتشغيل الاختبارات التي يحتوي عليها في قوائم اختبار متعددة, استخدم الخيار**/testlist** عدة مرات.

ملاحظة

يمكنك استخدام الخيار/testlistفقط إذا كنت تستخدم أيضاً الخيار /testmetadata .

يمكنك استخدام الخاصية**/testlist** و الخاصية /test معاً. هذا مكافئ لتحديد قائمة اختبارات واختبار فردي واحد أو أكثر في النافذة محرر قائمة الاخبارات ثم النقر فوق تشغيل اختبارات.

/category

/category:[عامل تصفية الفئة الافتراضية:]

قم بـاستخدام الخيار**/category**لتقوم بتحديد أي فئات اختبار يتم تشغيلها

ملاحظة

يجب عليك استخدام الخيار /testcontainer حتي تقوم بـاستخدام الخيار /category.

يمكنك فقط استخدام الخيار**/category** مرة واحدة لكل سطر أمر, لكن يمكنك تحديد فئات اختبار متعددة باستخدام عامل تصفية فئة الاختبار. عامل تصفية فئة الاختبار يتكون من أسماء فئة اختبار واحدة أو أكثر مفصولة عن طريق عوامل التشغيل المنطقية & ',' | 'أو'! ' ، '&!'. (عوامل التشغيل المنطقية & 'و' | ' لا يمكن استخدامهما معاً لإنشاء عامل تصفية فئة اختبار.)

على سبيل المثال:

  • /category:group1تقوم بـتشغيل الاختبارات في فئة الاختبار "group1".

  • **/category:"group1&group2"**يقوم بـتشغيل الاختبارات في كلاً من فئات الاختبار "group1" و "group2." الاختبارات الموجودة فقط في واحد من فئات الاختبار المحددة لن يتم تشغيلها.

  • **/category:"group1|group2"**يقوم بـتشغيل الاختبارات في فئة الاختبار "group1" أو "group2". سيتم أيضاً تشغيل الاختبارات الموجودة في كلا من فئات الاختبار .

  • /category:"group1&!group2" تشغيل الاختبارات من فئة الاختبار "group1" الغير موجودة في فئه الاختبار "group2." لن يتم تشغيل الاختبار الموجود في كلا من فئات الاختبار "group1" و "group2".

    ملاحظة

    إذا كان عامل التصفية الخاص بك يتكون من فئة واحدة مثل/category:group1،لا يجب عليك إحاطة عامل التصفية بـعلامات اقتباس. ومع ذلك، إذا كان عامل التصفية الخاص بك يشير الي أكثر من فئة مثل /category:"group1&group2"فيجب أن يكون عامل التصفية محاط بـعلامات اقتباس.

/test

/test:[dest_name]

قم بـاستخدام الخيار**/test** لتحديد اختبارات فردية ليتم تشغيلها لتقوم بتشغيل اختبارات متعددة,قم بـاستخدام الخيار**/test** عدة مرات.

ملاحظة

يمكنك استخدام الخيار/test مع إما الخيار/testcontainerأو الخيار/testmetadataولكن ليس مع كليهما.

يمكنك استخدام الخاصية**/testlist** و الخاصية /test معاً. هذا مكافئ لتحديد قائمة اختبارات واختبار فردي واحد أو أكثر في النافذة محرر قائمة الاخبارات ثم النقر فوق تشغيل اختبارات.

السلسلة التي تحددها مع الخيار /test تكون مستخدمة لمطابقة أسماء الاختبارات في حاوية اختبار أو في ملف اختبار بيانات تعريف. وهذا يعني أنه يمكنك تحديد اختبارات متعددة باستخدام قيمة واحدة لـ**/test**. على سبيل المثال،تحديد /test:ittestقد يقوم بـإنتاج مطابقات لاختبارات تسمي DebitTest 
و CreditTest لأن كلا الاسمين يحتوا علي السلسلة الفرعية 'ittest' .

ملاحظة

القيمة التي تحددها بالخيار /testيتم اختبارها ليس فقط مقابل اسم الاختبار ولكن أيضاً مسار هذا الاختبار كما في "مستكشف الحلول" أو مع اختبارات الوحدة إلى الاسم المؤهل بشكل كامل والخاص بهم.

مثالا الاستخدام التاليين:

مثال اختبار الوحدة: يحتوي الملف UnitTest1.cs في المشروع TestProject2 علي اختبار وحدة يسمي TestMethod1. تعيين قيمة ل 'ittest' للخيار /test سوف يطابق أيضاً هذا الاختبار لأن السلسلة يتم اختبارها مقابل الاسم المؤهل بشكل كامل "TestProject2.UnitTest1.TestMethod1"و تظهر السلسلة 'ittest' في 'UnitTest1'.

مثال اختبار عام: يقوم سطر الأوامر التالي بـتشغيل الاختبار العام المحدد ،و عرض المسار الكامل للاختبار في نتائج الاختبار.

mstest /testcontainer:"C:\Documents and Settings\<user name>\My Documents\Visual Studio\Projects\TestProject2\TestProject2\generictest1.generic" /test:testproject32\generic

/noisolation

/noisolation

قم بـاستخدام هذا الخيار لتشغيل الاختبارات داخل العملية MSTest.exe. لا يسبب استخدام هذا الخيار أية تغييرات أخرى فى تكوين تشغيل الاختبار. الغرض من هذا الخيار تحسين سرعة تشغيل الاختبار. ومع ذلك، يؤدي الي زيادة المخاطر لتشغيل الاختبار ككل بسبب وجود استثناء غير معالج جاء بواسطة اختبار التعليمات البرمجية وقد يؤدي إلى تعطل عملية MSTest.exe.

/testsettings

/testsettings:[اسم الملف]

قم بـاستخدام هذا الخيار لتحديد ملف اعدادات اختبار. فعلى سبيل المثال: /testsettings:local.Testsettings

يمكنك تحديد ملف إعدادات اختبار بطرق أخرى, مثل الخيار /testmetadata. القواعد التي تحكم مواصفات ملف إعدادات الاختبار موضحة هنا.

  • إذا استخدمت الخيار**/testsettings**سيتم استخدام الملف المعين ، إذا كنت تستخدم الخيار /testmetadata أيضاً .

  • إذا استخدمت الخيار**/testmetadata**لتشير الي ملف التعريف الذي يحدد ملف إعدادات الاختبار النشطة والذي سوف يستخدم ملف إعدادات الاختبار هذا إذا لم تكن تستخدم الخيار /testsettings.

  • إذا لم تستخدم الخيار**/testsettings**و لم تقم بتحديد ملف إعدادات اختبار في ملف بيانات تعريف الاختبار فإنه يستخدم تشغيل الاختبار ملف اعدادات الاختبار الافتراضي .

    ملاحظة

    لمزيد من المعلومات حول ملفات إعدادات الإختبار، أنظرإنشاء إعدادات اختبار لاختبارات تلقائية كجزء من خطة اختبار.

/runconfig

/runconfig:[اسم الملف]

ملاحظة خيار سطر الأوامر هذا يتم الاحتفاظ به للتوافق مع الإصدارات السابقة منMicrosoft Visual Studio 2010. قد تم استبدال تكوينات إعدادات الاختبار بإعدادت اختبار فيVisual Studio 2010 Ultimate.

قم بـاستخدام هذا الخيار لتحديد ملف تكوين تشغيل. فعلى سبيل المثال: /runconfig:localtestrun.Testrunconfig

يمكنك تحديد ملف تكوين تشغيل بطرق أخرى مثلا بـخيار /testmetadata. القواعد التي تحكم مواصفات ملفات تكوين التشغيل موضحة هنا.

  • إذا استخدمت الخيار**/runconfig**سيتم استخدام الملف المعين ، إذا كنت تستخدم الخيار /testmetadataأو لا.

  • إذا استخدمت الخيار**/testmetadata**لتشير الي ملف تعريف الذي يحدد ملف تكوين التشغيل النشط سوف يتم استخدام ملف تكوين التشغيل هذا إذا لم تكن تستخدم الخيار /runconfig.

  • إذا لم تستخدم الخيار**/runconfig**و لم تقم بتحديد ملف تكوين التشغيل في ملف بيانات تعريف الاختبار, يستخدم تشغيل الاختبار ملف تكوين التشغيل الافتراضي .

/resultsfile

/resultsfile:[اسم الملف]

قم بـاستخدام هذا الخيار لحفظ نتائج تشغيل الاختبار في الملف المسمى. فعلى سبيل المثال: /resultsfile:testResults.trx.

/unique

/unique

قم باستخدام الخيار /unique بالاقتران مع الخيار**/test**. يرشد الخيار /unique MSTest.exe لتشغيل فقط إجراء اختبار واحد الذي يطابق اسمه القيمة التي تدخلها مع الخيار**/test**.

على سبيل المثال، تحتوي حاوية الاختبار MyTestProject علي الاختبارات باسم MethodTest1 و MethodTest10.

سطر الأوامر :

mstest /testcontainer:testproject2.dll /test:MethodTest1

يتم تشغيل كلا من الاختبارين MethodTest1 و MethodTest10 ، لأن 'MethodTest1' هي سلسلة فرعية خاصة بـ 'MethodTest10'.

لكن سطر الأوامر

mstest /testcontainer:testproject2.dll /test:MethodTest1 /unique

يقوم بتشغيل الاختبار MethodTest1 فقط.

/usestderr

/usestderr

يؤدي استخدام هذا خيار المعلومات التالية المراد كتابتها إلى قياسي الخطأ:

  • اختبار باستخدام النتيجة فشل، Aborted، خطأ، موقوتة خارج، غير Runnable أو عدم تنفيذ.

  • تشغيل المستوى أخطاء.

  • أخطاء في تحليل الأمر خط الوسيطات.

  • تشغيل تلخيصية عند اختبار التشغيل لدى نتيجة فشل.

دون رقم هو خيار إخراج الجميع هو المرسلة إلى الإخراج القياسي.

/detail

/detail:[معرف الخاصية]

يُستخدم هذا الخيار لعرض خصائص حالة الاختبار الإضافية , إذا كانت موجودة. يمكنك تمرير أكثر من مثيل واحد من الخيار /detail كل بـمعرف خاصية واحد فقط في سطر أوامر واحد. معرف الخاصية الصالح للخيار**/detail**اتبع:

المحول

معرف

projectrelativepath

computername

isautomated

readonly

debugtrace

ارتباط

spoolmessage

نشرة الأمان

longtext

stderr

displaytext

اسم

stdout

فترة

outcometext

التخزين

errormessage

مالك

testcategoryid

errorstacktrace

parentexecid

testname

executionid

أفضلية

testtype

مجموعات

projectname

traceinfo

ملاحظة

التحديد الفعلي لمعرفات الخاصية التي يمكنك استخدامها مع الخيار /detail تختلف استناداً إلى نوع الاختبار. لذلك، تكون هذه القائمة مجرد تقريب. في الواقع. إذا كنت تستخدم أنواع اختبار مختلفة عن تلك التي تم تضمينها في أدوات الاختبار Team System ، سيكون تحديد الخصائص مختلف. لمعرفة أي propertyIDs يمكنك استخدامها, قم بـفحص ملف نتائج الاختبار التي تم إنتاجها من قبل تشغيل الاختبار. للحصول على مزيد من المعلومات حول حقول نتائج اختبار , انظر كيفية القيام بما يلي: حفظ و فتح نتائج الاختبار في Visual Studio.

في حالة وجود خاصية موجودة لحالة اختبار محددة, يتم تضمين المعلومات الخاصة بها في ملخص نتيجة الناتج.

على سبيل المثال، سطر الأوامر:

mstest /testcontainer:Errors.dll /detail:testtype

ينتج الناتج التالي الذي يحتوي على معلومات نوع الاختبار:

            ...
Results                    Top Level Tests
--------                   -----------------
Inconclusive               TestProject2.BankAccountTest.CreditTest
[testtype] = Unit Test
...

راجع أيضًا:

المبادئ

مراجعة نتائج الاختبار

تشغيل الاختبارات التلقائية من سطر الأوامر: