MSTest.exe - Opcje wiersza poleceń

MSTest.exe jest poleceniem wiersza polecenia, które jest używane do uruchamiania testów.To polecenie ma kilka opcji, których można użyć do dostosowania przebiegu testu.Wiele z tych opcji można użyć w połączeniu ze sobą; w rzeczywistości użycie pewnych opcji w połączeniu z innymi opcjami jest niezbędne, jak opisano w poniższych sekcjach.Te opcje można określać w dowolnej kolejności w wierszu polecenia MSTest.exe.

MSTest.exe nie interpretuje opcji lub wartości, które dla nich określono, pod względem wielkość liter.

Poniższa lista zawiera wszystkie opcje dla MSTest.exe i ich krótkie opisy.Podobne podsumowanie można zobaczyć, wpisując MSTest/h w wierszu polecenia.

Ogólne opcje wiersza polecenia

Opcje wiersza polecenia do publikowania wyników testów

Aby uzyskać więcej informacji o tych opcjach, zobacz Opcje wiersza polecenia dotyczące publikowania wyników testów.

Korzystanie z opcji MSTest

W poniższych sekcjach bardziej szczegółowo opisano wiele opcji dla MSTest.exe.Opcje, które były używane do publikowania wyników testów nie są tu uwzględniane.Aby uzyskać informacje o tych opcjach, zobacz Opcje wiersza polecenia dotyczące publikowania wyników testów.

/testcontainer

/testcontainer:[file name]

Kontener testu jest to plik zawierający testy, które chcesz uruchomić.Na przykład w odniesieniu do testów uporządkowanych kontenerem testu jest plik .orderedtest, który definiuje uporządkowany test.W przypadku testów jednostkowych jest to zestaw zbudowany na podstawie projektu testowego, który zawiera pliki źródłowe badania jednostki.

[!UWAGA]

W przypadku testów jednostkowych jest to zestaw, który zawiera kod testu, a nie zestaw zawierający kod testowanej aplikacji.Na przykład jeśli Twoje rozwiązanie zawiera projekt o nazwie BankAccount i odpowiadający mu projekt testu o nazwie BankAccountTest, określ parametr /testcontainer:BankAccountTest.dll.

[!UWAGA]

Ponieważ plik metadanych testów również zawiera testy, które można uruchomić, nie wolno określać jednocześnie opcji /testcontainer i /testmetadata w jednym wierszu polecenia. Zrobienie tak byłoby niejednoznaczne i spowodowało wygenerowanie błędu.

/testmetadata

/testmetadata:[file name]

Opcji /testmetadata można użyć, aby uruchomić testy w wielu kontenerach testowych.

Test pliku metadanych jest tworzony dla rozwiązania podczas tworzenia list testów przy użyciu okna edytora listy testów.Ten plik zawiera informacje o wszystkich testach wymienionych w oknie edytora listy testów.To wszystkie testy, które istnieją we wszystkich projektach testowych w rozwiązaniu.

Plik testu metadanych jest plikiem XML, który jest tworzony w folderze rozwiązania.Ten plik jest wyświetlany w oknie eksploratora rozwiązań pod węzłem Elementy rozwiązania.Plik metadanych testu ma rozszerzenie .vsmdi i jest skojarzony z oknem edytora listy testów.To znaczy, że po dwukrotnym kliknięciu pliku .vsmdi w Eksploratorze Windows (lub Eksploratorze plików) plik otworzy Visual Studio i jego zawartość.Wszystkie testy w projektach testów rozwiązania są wyświetlane w oknie edytora listy testów.

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

[!UWAGA]

Ponieważ kontener testów zawiera testy, które można uruchomić, nie wolno określać jednocześnie opcji /testcontainer i /testmetadata w jednym wierszu polecenia. Zrobienie tak byłoby niejednoznaczne i spowodowało wygenerowanie błędu.

Używając opcji /testmetadata, zaleca się że wskazanie konkretnych testów do uruchomienia za pomocą opcji /test lub /testlist albo obydwu.

/testlist

/testlist:[test list path]

Opcja /testlist jest listą testów, jak określono w pliku metadanych testu do uruchomienia.Aby uruchomić testy, które są zawarte w wielu listach testów, należy wielokrotnie skorzystać z opcji /testlist.Zostaną uruchomione wszystkie testy uporządkowane na liście testów.

[!UWAGA]

Opcji /testlist można używać tylko w przypadkach, gdy używana jest opcja /testmetadata.

Opcji /testlist i opcji /test można używać razem.Jest to równoważne zaznaczeniu zarówno listy testów oraz jednego lub więcej indywidualnych testów w oknie edytora listy testów i wybraniu opcji Uruchom testy.

/category

/category:[test category filter]

Użyj opcji /category w celu określenia kategorii test do uruchomienia.

[!UWAGA]

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

Z opcji /category można skorzystać tylko raz przy każdym poleceniu wiersza polecenia, ale można określić wiele kategorii testów z filtrem kategorii.Filtr kategorii test składa się z jednej lub kilku nazw kategorii testów oddzielonych od siebie operatorami logicznymi „&”, „|”, „! ”, „&!”.Operatorów logicznych '&' i '|' nie można używać razem, w celu utworzenia filtru kategorii testowych.

Na przykład:

• Polecenie /category:group1 uruchamia testy w kategorii testów „group1”.

• Polecenie /category:"group1&group2" uruchamia testy, które są w obu kategoriach testów „group1” i „group2”. Testy, które znajdują się tylko w jednej z określonych kategorii testowych, nie będą działać.

• Polecenie /category:"group1|group2" uruchamia testy, które są w kategorii testów „group1” lub „group2”.Zostaną również uruchomione testy w obu kategoriach.

• Polecenie /category:"group1&!group2" uruchamia testy z kategorii testów „group1”, których nie ma w kategorii testów „group2”. Test, który znajduje się zarówno w kategorii testów „group1”, jak i kategorii testów „group2”, nie będzie uruchamiany.

  [!UWAGA]

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

/test

/test:[test name]

Użyj opcji /test w celu określenia testów do uruchomienia.Aby uruchomić wiele testów, użyj wiele razy opcji /test.

[!UWAGA]

Opcji /test można użyć razem z opcją /testcontainer albo z opcją/testmetadata, ale nie można z obiema jednocześnie.

Opcji /testlist i opcji /test można używać razem.Jest to równoważne zaznaczeniu zarówno listy testów oraz jednego lub więcej indywidualnych testów w oknie edytora listy testów i wybraniu opcji Uruchom testy.

Ciąg znaków z opcją /test jest używany do dopasowania nazw testów w kontenerze testów lub pliku metadanych testowych.Oznacza to, że można określić wiele testów przy użyciu pojedynczej wartości dla /test.Na przykład określenie opcji /test:ittest wygeneruje dopasowania do testów o nazwie DebitTest i CreditTest, ponieważ obie nazwy testów zawiera podciąg „ittest”.

[!UWAGA]

Wartość, którą można określić za pomocą opcji /test, jest testowana nie tylko pod kątem nazwy testu, ale również ścieżki tego testu, jak widać w oknie Solution Explorer lub z testów jednostkowych, do ich w pełni kwalifikowanej nazwy.

Oto dwa przykłady użycia:

Przykład testu jednostki: plik UnitTest1.cs w projekcie TestProject2 zawiera test jednostki o nazwie TestMethod1.Określanie wartości 'ittest' dla opcji /test będzie również odpowiadać temu testowi, ponieważ ciąg jest testowany dla w pełni kwalifikowanej nazwy "TestProject2.UnitTest1.TestMethod1", a ciąg 'ittest' pojawia się również w 'UnitTest1'.

Przykładowy test generyczny: następujący wiersz polecenia uruchamia określony test generyczny 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

Ta opcja służy do uruchomienia testów w ramach procesu MSTest.exe.Użycie tej opcji nie powoduje innych zmian w konfiguracji przebiegu testu.Celem tej opcji jest przyspieszenie przebiegu testu.Zwiększa to jednak ryzyko uruchomienia testu jako całości, ponieważ nieobsługiwany wyjątek spowodowany przez kod testu mógłby spowodować awarię procesu MSTest.exe.

/testsettings

/testsettings:[file name]

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

Plik ustawień testu można określić w inny sposób, na przykład za pomocą opcji /testmetadata.Reguły rządzące specyfikacją uruchamiania plików ustawień testowych są opisane tutaj.

• Jeśli używasz opcji /testsettings, użyty będzie określony plik, niezależnie od tego, czy użyto również opcji /testmetadata.

• Jeśli używasz opcji /testmetadata, aby wskazać plik metadanych, który określa aktywny plik ustawień testowych, ten plik ustawień testowych będzie używany, jeśli nie korzystasz z opcji /testsettings.

• Jeśli nie używasz opcji /testsettings i nie określisz również pliku ustawień testu w pliku metadanych testu, w celu uruchomienia testu zostanie użyty domyślny plik ustawień.

  [!UWAGA]

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

/runconfig

/runconfig:[file name]

Uwaga Ta opcja wiersza polecenia jest utrzymywana ze względu na zgodność z poprzednimi wersjami programu Visual Studio.W programie Visual Studio Premium konfiguracje uruchamiania testów zostały zastąpione ustawieniami testów.

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

Plik konfiguracji przebiegu można określić w inny sposób, na przykład za pomocą opcji /testmetadata.Reguły rządzące specyfikacją uruchamiania plików konfiguracji są opisane tutaj.

• Jeśli używasz opcji /runconfig, użyty będzie określony plik, niezależnie od tego, czy użyto również opcji /testmetadata.

• Jeśli używasz opcji /testmetadata, aby wskazać plik metadanych, który określa aktywny plik konfiguracji uruchamiania, ten plik konfiguracji będzie używany, jeśli nie korzystasz z opcji /runconfig.

• Jeśli nie używasz opcji /runconfig i nie określisz również pliku konfiguracji uruchamiania w pliku metadanych testu, w celu uruchomienia testu zostanie użyty domyślny plik konfiguracji.

/resultsfile

/resultsfile:[file name]

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

/usestderr

/usestderr

Użycie tej opcji spowoduje zapisanie do błędu standardowego następujących informacji:

• Testy z wynikiem Niepowodzenie, Przerwano, Błąd, Upłynął limit czasu, Niemożliwy do uruchomienia lub Nie wykonany.

• Uruchom błędy danego poziomu.

• Błędy podczas analizy składni argumentów wiersza polecenia.

• Uruchom podsumowanie, gdy uruchomienie testu kończy się niepowodzeniem.

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

/detail

/detail:[property id]

Ta opcja służy do wyświetlania dodatkowych właściwości przypadku testowego, jeśli takie istnieją.Można przekazać więcej niż jedno wystąpienie opcji /detail, każde z tylko jednym identyfikatorem właściwości, w jednym wierszu polecenia.Ważne identyfikatory właściwości dla opcji /detail:

[!UWAGA]

Rzeczywiste wybrane identyfikatory właściwości, których można używać z opcją /detail, różnią się w zależności od typu testu.W związku z tym ta lista jest tylko przybliżeniem.W szczególności jeśli używasz typów testu niestandardowego, wybór właściwości może się różnić.Aby dowiedzieć się, którego identyfikatora propertyId możesz użyć, sprawdź plik wyników testu.Aby uzyskać więcej informacji na temat wyników testów, zobacz Porady: zapisywanie i otwieranie wyników wydajności sieci Web i testów obciążenia w programie Visual Studio.

Jeśli właściwość istnieje dla określonych przypadków testowych, informacje te znajdują się w podsumowaniu wyników danych wyjściowych.

Na przykład wiersz polecenia:

mstest /testcontainer:Errors.dll /detail:testtype

generuje następujące dane wyjściowe, zawierające informacje o typie testu:

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

Zobacz też

Koncepcje

Uruchamianie testów automatycznych w wierszu polecenia

Inne zasoby

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