MSTest.exe opcje wiersza polecenia

MSTest.exe jest polecenia, który jest używany do uruchamiania testów.To polecenie udostępnia kilka opcji, które można użyć, aby dostosować swoje przebieg testu.Wiele z tych opcji można użyć w połączeniu ze sobą; w rzeczywistości należy użyć pewnych opcji, w połączeniu z innymi opcjami, jak opisano w poniższych sekcjach.Te opcje można określić w dowolnej kolejności, w wierszu polecenia MSTest.exe.

MSTest.exe nie interpretuje opcje lub wartości, które określisz dla nich z rozróżnianiem.

W poniższej tabeli wymieniono wszystkie opcje dla MSTest.exe i krótkie opisy.Zobaczyć podsumowanie podobne, należy wpisać MSTest/h w wierszu polecenia.

Ogólne opcje wiersza polecenia

/testcontainer:[Nazwa pliku]	Załaduj plik, który zawiera testy. Przykład:/testcontainer:tests.dll Aby uzyskać więcej informacji, zobacz /testcontainer.
/testmetadata:[Nazwa pliku]	Załaduj plik, który zawiera metadane test.Aby uzyskać więcej informacji, zobacz /testmetadata.
/testlist:[Ścieżka listy test]	Umożliwia określenie listy badanie, jak określono w pliku metadanych do uruchomienia.Aby uzyskać więcej informacji, zobacz /testlist.
/category:[przetestować filtr kategorii]	Określ i filtrować kategorie badania, które do uruchomienia.Aby uzyskać więcej informacji, zobacz /Category.
/test:[Nazwa testu]	Należy podać nazwę testu do uruchomienia.Aby uzyskać więcej informacji, zobacz /test.
/noisolation	Uruchom testy w ramach procesu MSTest.exe.Wybór ten zwiększa szybkość przebieg testu, ale zwiększa ryzyko procesu MSTest.exe.
/testsettings: [Nazwa pliku]	Użyj pliku ustawień przeprowadzenia badania. Przykład:/testsettings:Local.Testsettings Aby uzyskać więcej informacji, zobacz /testsettings.
/runconfig:[Nazwa pliku]	Użyj określonego wykonywania pliku konfiguracji. Przykład:/runconfig:localtestrun.Testrunconfig Aby uzyskać więcej informacji, zobacz /runconfig. Uwaga Ta opcja wiersza polecenia jest utrzymywana zgodność z poprzednimi wersjami programu Visual Studio.Konfiguracje przebieg testu zostały zastąpione przez ustawienia testu w Visual Studio premii.
/resultsfile:[Nazwa pliku]	Zapisz testu wyniki do określonego pliku. Przykład:/resultsfile:testResults.trx Aby uzyskać więcej informacji, zobacz /resultsfile.
/detail:[Identyfikator właściwości]	Określ nazwę właściwości, które mają być wyświetlane wartości, jeśli istnieją, oprócz wynik testu.Aby uzyskać więcej informacji, zobacz /detail.
/help	Wyświetl sposobie użycia MSTest.exe (skrócona forma: /? lub /h).
/nologo	Wyświetlić nie transparentu startowego i komunikatu o prawach autorskich.
/usestderr	Użyj błąd standardowy, aby dane wyjściowe informacje o błędach.

Opcje wiersza polecenia dla publikowanie wyników badań

Aby uzyskać więcej informacji o tych opcjach, zobacz Opcje wiersza polecenia dla publikowanie wyników badań.

/publish:[Nazwa serwera]	Publikowanie wyników bazy danych dla Kolekcja projektów zespołu określonego serwera.
/publishresultsfile:[Nazwa pliku]	Określić, że nazwa do opublikowania pliku wyników.Jeśli nazwa pliku wyników nie jest określony, należy użyć pliku produkowane przez bieżący element.
/publishbuild:[Budowanie id]	Publikowanie wyników badań, przy użyciu tego identyfikatora kompilacji.
/teamproject:[Nazwa zespołu projektu]	Określ nazwę zespołu projektu, do której należy budować.
/platform:[Platforma]	Określ platformie kompilacji, wobec których próby wyniki powinny być publikowane.
/flavor:[smak]	Określ smak kompilacji, wobec których próby wyniki powinny być publikowane.

Korzystając z opcji MSTest

W poniższych sekcjach opisano wiele opcji dla MSTest.exe bardziej szczegółowo.Nie włącza się tu opcje, które były używane do publikowania wyników badań.Aby uzyskać informacje o tych opcjach, zobacz Opcje wiersza polecenia dla publikowanie wyników badań.

/testcontainer

/testcontainer:[Nazwa pliku]

Kontener testu jest plik, który zawiera testów, które chcesz uruchomić.Na przykład w odniesieniu do badań zamówione, kontener testu jest plik .orderedtest, który definiuje zamówione test.W przypadku testów jednostkowych jest zgromadzenie utworzonego na podstawie projektu test, który zawiera pliki źródłowe testu jednostki.

[!UWAGA]

W przypadku testów jednostkowych jest zestaw, który zawiera kod testu, nie zestaw, który zawiera kod aplikacji, która będzie testowana.Na przykład rozwiązanie zawiera projekt o nazwie prezentowanie ich i odpowiednie badanie projektu o nazwie BankAccountTest, ustawić /testcontainer:BankAccountTest.dll.

[!UWAGA]

Ponieważ test pliku metadanych zawiera również listę testów, które można uruchomić, nie można określić zarówno /testcontainer i /testmetadata opcje w wierszu polecenia.Ten sposób byłby niejednoznaczne i produkują błąd.

/testmetadata

/testmetadata:[Nazwa pliku]

Można użyć /testmetadata opcję, aby uruchomić testy w wielu pojemniki do badań.

Test pliku metadanych jest tworzony dla rozwiązania, podczas tworzenia list test za pomocą okna edytora listy przetestować.Ten plik zawiera informacje o wszystkich testów wymienionych w oknie edytora listy Test.Są to wszystkie testy, które istnieją we wszystkich projektach test w rozwiązaniu.

Test pliku metadanych jest plik XML, który jest tworzony w folderze rozwiązania.Ten plik jest wyświetlany w oknie Solution Explorer pod Elementy rozwiązania węzła.Plik metadanych testowy ma .vsmdi rozszerzenie i wiąże się z okna edytora listy przetestować.Oznacza to, jeśli klikniesz dwukrotnie plik .vsmdi w Eksploratorze Windows (lub Eksploratora plików), plik zostanie otwarty Visual Studio i jego zawartość.Wszystkie testy w projektach badań rozwiązania są wyświetlane w oknie edytora listy przetestować.

Test pliku metadanych można zmienić tylko przez wprowadzanie zmian, które są odzwierciedlone w oknie Test edytora listy, takie jak tworzenie lub usuwanie testów lub zmiana właściwości test.

[!UWAGA]

Ponieważ kontener testu zawiera testów, które można uruchomić, nie można określić zarówno /testcontainer i /testmetadata opcje w wierszu polecenia.Ten sposób byłby niejednoznaczne i produkują błąd.

Podczas korzystania z /testmetadata opcji, zaleca się że możesz wskazać konkretne badania przy użyciu /test opcji lub /testlist lub opcję oba.

/testlist

/testlist:[Ścieżka listy test]

/testlist Opcji znajduje się wykaz badań, jak określono w pliku metadanych test do uruchomienia.Aby uruchomić testy, które są zawarte w wielu listach test, należy /testlist opcji wiele razy.Zostaną uruchomione wszystkie zamówione testy na liście test.

[!UWAGA]

Można użyć /testlist tylko w przypadkach umożliwia również /testmetadata opcji.

Można użyć /testlist opcji i /test opcja razem.Jest to równoważne wybór listy testu i jeden lub więcej indywidualnych testów w oknie Test Edytor listy, a następnie wybierając Uruchomić testy.

/ category

/category:[przetestować filtr kategorii]

Użycie /category opcję w celu określenia kategorii test do uruchomienia.

[!UWAGA]

Należy użyć /testcontainer opcji, aby korzystać z /category opcji.

Można używać tylko /category opcji raz dla każdego wiersza polecenia, ale wiele kategorii test można określić za pomocą testu filtr kategorii.Filtr kategorii test składa się z nazwy kategorii co najmniej jeden test oddzielone operatorami logicznymi 'i', ' | ','!', 'i'!.Operatory logiczne 'i' i ' |' nie można używać razem do utworzenia filtru kategorii testów.

Na przykład:

• /category:group1uruchamia testy w kategorii test "grupa1".

• **/category:"group1&group2"**uruchamia testy, które znajdują się w kategorii test "grupa1" i "grupa2." Nie zostaną uruchomione testy, które znajdują się w jednej z kategorii badania.

• **/category:"group1|group2"**uruchamia testy, które znajdują się w kategorii test "grupa1" lub "grupa2".Także zostaną uruchomione testy, które znajdują się w obu kategorii test.

• **/category:"group1&!group2"**uruchamia testy z kategorii test "grupa1", które nie należą do kategorii test "grupa2." Test, który znajduje się w kategorii test "grupa1" i "grupa2" nie będzie działać.

  [!UWAGA]

  Jeśli filtr składa się z jednej kategorii takich jak /category:group1, nie trzeba ująć w cudzysłów filtr.Jednakże jeśli filtr odwołuje więcej niż jednej kategorii, takich jak /category:"group1&group2" , a następnie filtr musi być ujęty w znaki cudzysłowu.

wystawowy

/test:[Nazwa testu]

Użycie /test opcję w celu określenia indywidualnych testów do uruchomienia.Aby uruchomić wiele testów, należy /test opcji wiele razy.

[!UWAGA]

Można użyć /test opcja z jednej /testcontainer opcja lub z /testmetadata opcji, ale nie z obu.

Można użyć /testlist opcji i /test opcja razem.Jest to równoważne wybór listy testu i jeden lub więcej indywidualnych testów w oknie Test Edytor listy, a następnie wybierając Uruchomić testy.

Ciąg znaków z /test opcja jest używana do odpowiadają nazwom testów w kontenerze testu lub plik testowy metadanych.Oznacza to, że można określić wielu testów przy użyciu pojedynczej wartości dla /test.Na przykład określając /test:ittest w efekcie uzyskalibyśmy dopasowań dla badań o nazwie DebitTest i CreditTest, ponieważ oba przetestować nazwy zawierać podciąg 'ittest'.

[!UWAGA]

Wartość, która zostanie określona z /test opcja bada się przed nie tylko nazwę testu, ale także ścieżkę tego testu, jak widać w oknie Solution Explorer lub z testów jednostkowych, do ich w pełni kwalifikowanej nazwy.

Należy wykonać dwa przykłady użycia:

Przykład testu jednostki: plik UnitTest1.cs w programie project TestProject2 zawiera testu jednostki o nazwie TestMethod1.Określając wartość 'ittest' dla opcji wystawowy obejmie również tego testu, ponieważ ciąg jest testowana w pełni kwalifikowaną nazwę "TestProject2.UnitTest1.TestMethod1", a ciąg "ittest" pojawia się również w 'UnitTest1'.

Przykład Generic-test: następujący wiersz polecenia jest uruchamiana określonego testu rodzajowy i, w wynikach testu Wyświetla pełną ścieżkę badania.

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

/noisolation

/noisolation

Opcja ta jest przydatna w celu uruchomienia testów w ramach procesu MSTest.exe.Użycie tej opcji powoduje, że nie inne zmiany w konfiguracji testu.Celem tej opcji jest do zwiększenia szybkości przebieg testu.Jednak zwiększa ryzyko na próbę działać jako całości, ponieważ nieobsłużony wyjątek kodu testu mogłoby spowodować awarię procesu MSTest.exe.

/testsettings

/testsettings:[Nazwa pliku]

Ta opcja umożliwia określenie pliku ustawień testu.Na przykład: /testsettings:local.Testsettings

Pliki ustawień testu w inny sposób, takie jak można określić z opcją /testmetadata.Reguły rządzące specyfikacji przetestować ustawienia, które pliki są opisane w tym miejscu.

• Klienci korzystający z /testsettings opcji, plik, który określa będą stosowane, czy też użyć /testmetadata opcji.

• Klienci korzystający z /testmetadata opcję, aby wskazać plik metadanych, który określa plik ustawień active badania, że test pliku ustawień będą używane, jeśli nie używasz /testsettings opcji.

• Jeśli nie skorzystasz z /testsettings opcję a także nie zostanie z pliku ustawień testu w pliku metadanych test, biegiem próbnym używa domyślnego ustawienia pliku testowego.

  [!UWAGA]

  Aby uzyskać więcej informacji na temat testu ustawienia plików, zobacz Tworzenie ustawień automatycznych testów systemowych przy użyciu programu Microsoft Test Manager.

/runconfig

/runconfig:[Nazwa pliku]

Uwaga tej opcji wiersza polecenia jest utrzymywana zgodność z poprzednimi wersjami programu Visual Studio.Konfiguracje przebieg testu zostały zastąpione przez ustawienia testu w Visual Studio premii.

Ta opcja umożliwia określenie pliku konfiguracyjnego wykonywania.Na przykład: /runconfig:localtestrun.Testrunconfig

Plik konfiguracji wykonywania w inny sposób, takie jak można określić z opcją /testmetadata.Reguły rządzące specyfikacji plików konfiguracyjnych wykonywania zostały opisane w tym miejscu.

• Klienci korzystający z /runconfig opcji, plik, który określa będą stosowane, czy też użyć /testmetadata opcji.

• Klienci korzystający z /testmetadata opcję, aby wskazać plik metadanych, który określa plik active wykonywania konfiguracji, uruchom plik konfiguracji będą używane, jeśli nie używasz /runconfig opcji.

• Jeśli nie skorzystasz z /runconfig opcję a także nie zostanie plik konfiguracji uruchomić w metadanych pliku testowego, biegiem próbnym wykorzystuje plik konfiguracji uruchomi się domyślny.

/resultsfile

/resultsfile:[Nazwa pliku]

Ta opcja służy do zapisywania wyników testu w nazwanym pliku.Na przykład: /resultsfile:testResults.trx.

/usestderr

/usestderr

Użycie tej opcji spowoduje, że następujące informacje są zapisywane do błędu standardowego:

• Testy z wynikiem nie powiodło się, przerwanie transakcji, błąd, upłynął nie możliwe do uruchomienia lub nie jest wykonywane.

• Uruchom błędy na poziomie.

• Błędy w analizowanie argumentów wiersza polecenia.

• Testowa ma wynik obawy o błędy, uruchom podsumowania.

Bez tej opcji wszystkie dane wyjściowe są wysyłane do wyjścia standardowego.

/detail

/detail:[Identyfikator właściwości]

Ta opcja służy do wyświetlania właściwości dodatkowe przypadku testowego, jeśli takie istnieją.Można przekazać więcej niż jedno wystąpienie /detail opcja, każdy o identyfikatorze tylko jednej właściwości, w jednym wierszu polecenia.Identyfikator prawidłowej właściwości dla /detail opcji wykonaj:

Adapter	Identyfikator	projectrelativepath
nazwa_komputera	isautomated	tylko do odczytu
debugtrace	łącze	spoolmessage
Opis	LONGTEXT	stderr
wyświetlany_tekst	Nazwa	STDOUT
czas trwania	outcometext	pamięci masowej
komunikat o błędzie	właściciel	testcategoryid
errorstacktrace	parentexecid	nazwa_testu
executionid	priorytet	testtype
grupy	NazwaProjektu	traceinfo

[!UWAGA]

Rzeczywisty wybór nieruchomości identyfikatorów, które można używać z opcją /detail zmienia się odpowiednio typ testu.W związku z tym ta lista jest tylko przybliżeniem.W szczególności jeśli używane są typy niestandardowe testu, wybór właściwości będzie inny.Wiedzieć, propertyIDs, których można użyć, należy przejrzeć plik wyników testu wydzielana z jazd testowych.Aby uzyskać więcej informacji na temat badań zakończyło się plików, zobacz Jak: Zapisz i Otwórz wyniki w programie Visual Studio.

Jeśli właściwość istnieje dla określonego przypadku testowego, jego informacje znajdują się w podsumowaniu wyników dane wyjściowe.

Na przykład wiersz polecenia:

mstest /testcontainer:Errors.dll /detail:testtype

wyświetli, który zawiera informacje o typie test:

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

Zobacz też

Koncepcje

Sprawdzanie wyników testów w programie Microsoft Test Manager

Uruchamianie automatyczne testy z wiersza polecenia