Možnosti příkazového řádku MSTest.exe

Článek
06/07/2013

MSTest.exe je nástroj příkazového řádku pro spuštění testů.Tento příkaz má několik možností, které můžete použít k přizpůsobení vašeho testu.Mnohé z těchto možností můžete použít ve spojení s sebou; ve skutečnosti musíte použít některé možnosti ve spojení s jinými možnostmi, jak je popsáno v následujících částech.Tyto možnosti můžete zadat v libovolném pořadí pomocí příkazového řádku MSTest.exe.

MSTest.exe neinterpretuje volby nebo hodnoty, které zadáte pro ně s rozlišováním.

Následujících tabulkách jsou uvedeny všechny možnosti pro MSTest.exe a krátké popisy.Podobné shrnutí můžete zobrazit zadáním MSTest/h na příkazovém řádku.

Obecné možnosti příkazového řádku

/testcontainer:[Název souboru]	Načtěte soubor, který obsahuje testy. Příklad:/testcontainer:tests.dll Další informace naleznete v tématu /testcontainer.
/testmetadata:[Název souboru]	Načtěte soubor, který obsahuje test metadata.Další informace naleznete v tématu /testmetadata.
/testlist:[Cesta k seznamu test]	Zadejte seznam zkoušky uvedené v souboru metadat má být spuštěn.Další informace naleznete v tématu /testlist.
/category:[Filtr kategorie test]	Určit a filtrovat test kategorií, které chcete spustit.Další informace naleznete v tématu /category.
/test:[název testu]	Zadejte název test proběhnout.Další informace naleznete v tématu /test.
/noisolation	Spuštění testů v rámci procesu MSTest.exe.Tuto volbu je možné zrychlit zkušební jízdy, ale zvyšuje riziko pro MSTest.exe proces.
/testsettings: [Název souboru]	Použití souboru nastavení zadaném testu. Příklad:/testsettings:Local.Testsettings Další informace naleznete v tématu /testsettings.
/runconfig:[Název souboru]	Použijte zadané spuštění konfiguračního souboru. Příklad:/runconfig:localtestrun.Testrunconfig Další informace naleznete v tématu /runconfig. Poznámka Tento parametr příkazového řádku bude zachována kompatibilita s předchozími verzemi sady Visual Studio.Konfigurace testu byly nahrazeny test nastavení v aplikaci Visual Studio Premium.
/resultsfile:[Název souboru]	Uložte testu výsledky do zadaného souboru. Příklad:/resultsfile:testResults.trx Další informace naleznete v tématu /resultsfile.
/detail:[Vlastnost id]	Zadejte název vlastnosti, kterou chcete zobrazit hodnoty, pokud existuje, kromě výsledku testu.Další informace naleznete v tématu /detail.
/help	Zobrazit zprávu o použití MSTest.exe (krátký tvar: /? nebo /h).
/nologo	Zobrazit žádné úvodní nápis a zprávu o autorských právech.
/usestderr	Používejte standardní chyby pro informace o chybě výstup.

Možnosti příkazového řádku pro publikování výsledků zkoušek

Další informace o těchto možnostech naleznete v Možnosti příkazového řádku pro publikování výsledků zkoušek.

/publish:[název serveru]	Publikování výsledků do databáze pro kolekce týmového projektu určeného serveru.
/publishresultsfile:[Název souboru]	Zadejte že název pro publikování souboru výsledků.Pokud není zadán žádný název souboru výsledků, použijte soubor vytvořený pomocí daného spuštění.
/publishbuild:[vytvoření id]	Publikovat výsledky testu pomocí tohoto ID sestavení.
/teamproject:[Název týmu projektu]	Zadejte název týmu projektu, ke kterému patří sestavení.
/platform:[Platforma]	Určete platformu sestavení, proti které zkoušky by měly být zveřejňovány výsledky.
/flavor:[charakter]	Určete charakter sestavení, proti které zkoušky by měly být zveřejňovány výsledky.

Pomocí možnosti MSTest

Následující oddíly popisují mnoho možností pro MSTest.exe podrobněji.Možnosti, které byly použity pro publikování výsledků zkoušek zde nejsou uvedeny.Informace o těchto možnostech naleznete v tématu Možnosti příkazového řádku pro publikování výsledků zkoušek.

/testcontainer

/testcontainer:[Název souboru]

Kontejner testu je soubor, který obsahuje testy, které mají být spuštěny.Kontejner testu je objednané zkoušky pro .orderedtest soubor, který definuje uspořádanou test.Pro testování částí je sestavení vytvořeno z zkušební projekt, který obsahuje zdrojové soubory pro test jednotky.

[!POZNÁMKA]

Pro testování částí to je sestavení, které obsahuje testovací kód není sestavení obsahující kód aplikace, který testujete.Například pokud vaše řešení obsahuje projekt s názvem bankovní účet a odpovídající zkušební projekt s názvem BankAccountTest, zadejte /testcontainer:BankAccountTest.dll.

[!POZNÁMKA]

Protože testovacího souboru metadat obsahuje také seznam testů, které lze spustit, nesmíte zadat i /testcontainer a /testmetadata volby do jednoho příkazového řádku.Tím by byly nejednoznačné a by dojít k chybě.

/testmetadata

/testmetadata:[Název souboru]

Můžete použít /testmetadata možnost spustit testy v několika nádobách test.

Test metadat souboru je vytvořen pro vaše řešení, při vytváření seznamů test pomocí okna editoru seznam otestovat.Tento soubor obsahuje informace o všechny testy, které jsou uvedeny v okně editoru seznam testů.Jedná se o všechny testy, které existují ve všech projektech test ve vašem řešení.

Test metadat souboru je soubor XML, který je vytvořen ve složce řešení.Tento soubor je zobrazen v Průzkumníku řešení pod Položky řešení uzlu.Testovací soubor metadat má příponu .vsmdi a je spojen s okno editoru seznam otestovat.To znamená, pokud dvakrát kliknete na soubor .vsmdi v programu Průzkumník Windows (nebo File Explorer), soubor se otevře Visual Studio a jeho obsah.Všechny testy v testovací projekty řešení jsou zobrazeny v okně editoru seznam otestovat.

Test metadat souboru můžete změnit pouze tím, že změny, které se projeví v okně Test editoru seznamu, například vytváření nebo odstraňování zkoušky nebo změna vlastností test.

[!POZNÁMKA]

Protože kontejner testu obsahuje testy, které lze spustit, nesmíte zadat i /testcontainer a /testmetadata volby do jednoho příkazového řádku.Tím by byly nejednoznačné a by dojít k chybě.

Při použití /testmetadata možnost, je vhodné označení specifické testy provozovat /test možnost nebo /testlist možnost nebo obojí.

/testlist

/testlist:[Cesta k seznamu test]

/testlist Možností je seznam testů podle testovacího souboru metadat má být spuštěn.Chcete-li spustit testy, které jsou obsaženy ve více seznamech test, použijte /testlist možnost vícekrát.Budou spuštěny všechny objednané testy v seznamu test.

[!POZNÁMKA]

Můžete použít /testlist možnost pouze v případě, že je také použít /testmetadata možnost.

Můžete použít /testlist možnost a /test možnost společně.Jedná se o ekvivalent výběru seznamu zkoušky a jeden nebo více jednotlivých testů v okně Test editoru seznamu a potom zvolíte Spustit testy.

/ category

/category:[Filtr kategorie test]

Použití /category možnosti určíte, jaké kategorie test spustit.

[!POZNÁMKA]

Je nutné použít /testcontainer možnost, chcete-li použít /category možnost.

Lze použít pouze /category možnost jedenkrát na příkazový řádek, ale můžete zadat více kategorií test s filtrem kategorie test.Filtr kategorie zkouška se skládá z jednoho nebo více zkušebních názvy kategorií oddělené logické operátory 'a', ' | ','!', 'a'!.Logické operátory 'a' a ' |' nelze použít společně vytvořit filtr kategorie test.

Například:

/category:group1spustí testy test kategorie "skupina 1".
**/category:"group1&group2"**spuštění testů, které jsou v testu kategorie "skupina1" a "skupina2." Testy, které jsou pouze v jedné z kategorií stanoveným zkušebním nebudou spuštěny.
**/category:"group1|group2"**spustí testy, které jsou v kategorii skupina "test 1" nebo "skupina2".Testy, které jsou v obou kategoriích test také poběží.
**/category:"group1&!group2"**spuštění testů z kategorie testovací "skupina 1", které nejsou v kategorii test "skupina2." Test, který je v kategorii skupina "test 1" a "skupina2" nebudou spuštěny.

[!POZNÁMKA]

Je-li filtr se skládá z jedné kategorie, jako je například /category:group1, není nutné filtr uzavřete do uvozovek.Avšak je-li filtr využívá více než jedné kategorie, například /category:"group1&group2" filtru musí být uzavřeny v uvozovkách.

/Test

/test:[název testu]

Použití /test možnost, chcete-li určit jednotlivé testy k provedení.Chcete-li spustit více testů, použijte /test možnost vícekrát.

[!POZNÁMKA]

Můžete použít /test možnost buď /testcontainer možnost nebo /testmetadata možnost, ale s oběma.

Řetězec, který zadáte pro /test je možnost používané názvy testů v kontejneru test nebo test souboru metadat.To znamená, že je možné zadat více testů pomocí jednu hodnotu pro /test.Například zadáním /test:ittest vytvoří odpovídající položky pro zkoušky s názvem DebitTest a CreditTest, protože obě testovací názvy obsahovat dílčí řetězec "ittest".

[!POZNÁMKA]

Hodnota, kterou zadáte pomocí /test možnost je testován vůči nejen název zkoušky, ale také cestu k té zkoušce, jak je vidět v okně Průzkumník řešení, nebo se testování částí jejich plně kvalifikovaný název.

Dva příklady využití následujícím:

Testování příklad: soubor UnitTest1.cs v projektu TestProject2 obsahuje test jednotky s názvem TestMethod1.Určující hodnotu "ittest" pro možnost /test by také odpovídalo tento test, protože řetězec je testován vůči plně kvalifikovaný název "TestProject2.UnitTest1.TestMethod1" a řetězec "ittest" se zobrazí také v "UnitTest1".

Příklad obecný test: následující příkaz spustí zadaný obecný test a výsledky testu zobrazí úplnou cestu ke zkoušce.

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

/noisolation

/noisolation

Tuto možnost použijte, chcete-li spustit testy v rámci procesu MSTest.exe.Pomocí této možnosti způsobí, že žádné další změny test spuštění nástroje Konfigurace.Účelem této možnosti je zlepšit spustit test rychlosti.Však zvyšuje riziko pro test spustit jako celek, protože neošetřené výjimky vyvolané testovacího kódu by způsobit, že proces MSTest.exe zhroucení.

/testsettings

/testsettings:[Název souboru]

Tuto možnost použijte k určení nastavení souboru test.Například: /testsettings:local.Testsettings

Testovací soubor nastavení jinými způsoby, například můžete zadat s parametrem /testmetadata.Pravidla, která řídí specifikace otestovat nastavení, které soubory jsou popsané zde.

Použijete-li /testsettings možnost, soubor, který určuje bude použit, zda můžete použít také /testmetadata možnost.
Použijete-li /testmetadata možnost odkazovat na soubor metadat, který určuje soubor nastavení aktivní test, test souboru nastavení bude použito, pokud nepoužijete /testsettings možnost.
Pokud nepoužijete /testsettings a rovněž není testovací soubor nastavení v souboru metadat test, zkušební jízdy používá výchozí soubor nastavení testu.

[!POZNÁMKA]

Další informace o testovacích souborů nastavení, viz Vytváření nastavení testů pro automatizované systémové testy pomocí nástroje Microsoft Test Manager.

/runconfig

/runconfig:[Název souboru]

Poznámka: tento parametr příkazového řádku je zachována kompatibilita s předchozími verzemi sady Visual Studio.Konfigurace testu byly nahrazeny test nastavení v aplikaci Visual Studio Premium.

Tuto možnost použijte, chcete-li určit spuštění konfiguračního souboru.Například: /runconfig:localtestrun.Testrunconfig

Spustit konfigurační soubor jinými způsoby, jako můžete zadat s parametrem /testmetadata.Pravidla, která řídí specifikace běhu konfigurační soubory jsou popsané zde.

Použijete-li /runconfig možnost, soubor, který určuje bude použit, zda můžete použít také /testmetadata možnost.
Použijete-li /testmetadata možnost tak, aby odkazoval na soubor metadat, která určuje aktivní spuštění konfiguračního souboru, který spustit konfigurační soubor bude použit, pokud nepoužijete /runconfig možnost.
Pokud nepoužijete /runconfig a rovněž není spuštění konfiguračního souboru v souboru metadat test, zkušební jízdy používá výchozí spustit konfigurační soubor.

/resultsfile

/resultsfile:[Název souboru]

Pomocí této možnosti můžete uložit do souboru s názvem výsledky testů.Příklad: /resultsfile:testResults.trx.

/usestderr

/usestderr

Pomocí této možnosti způsobí, že následující informace, které mají být zapsány do standardního chybového:

Testy s výsledkem neúspěšný, bylo přerušeno, chyby vypršení časového limitu není spustitelného nebo nebyly provedeny.
Spuštění chyby na úrovni.
Chyby při analýze argumenty příkazového řádku.
Spusťte souhrn po selhání výsledek zkoušky.

Bez této možnosti je odeslán veškerý výstup do standardního výstupu.

/Detail

/detail:[Vlastnost id]

Tato možnost slouží k zobrazení vlastností další testového případu, pokud existují.Můžete předat více než jednu instanci /detail možnost, každá má pouze jednu vlastnost ID do jednoho příkazového řádku.Platnou vlastnost id pro /detail následující možnosti:

adaptér	id	projectrelativepath
název_počítače	isautomated	jen pro čtení
debugtrace	odkaz	spoolmessage
Popis	LONGTEXT	STDERR
ZobrazenýText	name	STDOUT
Doba trvání	outcometext	úložiště
errorMessage	Vlastník	testcategoryid
errorstacktrace	parentexecid	název_testu
executionid	Priorita	testtype
skupiny	název projektu	traceinfo

[!POZNÁMKA]

Skutečný výběr vlastnost ID, které lze použít s parametrem /detail se liší podle typu testu.Proto tento seznam je pouze přibližný.Zejména pokud používáte vlastní test typy, výběr vlastností bude lišit.Vědět, propertyIDs, které můžete použít, zkontrolujte soubor výsledky testu vyrábí zkušební jízdy.Další informace o test výsledky soubory, naleznete v Jak: Uložit a otevřít v aplikaci Visual Studio výsledky zkoušek.

Jestliže některá vlastnost existuje pro zadaný testového případu, jeho informace jsou obsaženy v souhrnu výsledků výstupní.

Například na příkazovém řádku:

mstest /testcontainer:Errors.dll /detail:testtype

vytvoří následující výstup, který obsahuje informace o typu testu:

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

Viz také

Koncepty

Vyhodnocení výsledků testů v nástroji Microsoft Test Manager

Automatické spuštění testů z příkazového řádku

Sdílet prostřednictvím