Opções da Linha de Comando MSTest.exe
MSTest.exe é o comando de linha de comando que é usado para executar testes.Esse comando terá várias opções que você pode usar para personalizar sua execução de teste.Você pode usar muitas dessas opções em conjunto com uma outra; na verdade, você deve usar determinadas opções em conjunto com outras, conforme descrito nas seções a seguir.Você pode especificar essas opções em qualquer ordem na linha de comando MSTest.exe.
MSTest.ext não interpretará as opções nem os valores especificados para as opções de maneira a diferenciar maiúsculas de minúsculas.
As tabelas a seguir listam todas as opções para MSTest.exe e breves descrições destas.You can see a similar summary by typing MSTest/h at a command line.
Opções Gerais de Linha de Comando
/testcontainer:[Nome do Arquivo] |
Carregar um arquivo que contém testes. Exemplo: /testcontainer:tests.dll Para obter mais informações, consulte /testcontainer. |
/testmetadata:[Nome do Arquivo] |
Carrega um arquivo que contém metadados de testes.Para obter mais informações, consulte /testmetadata. |
/testlist:[caminho da lista de testes] |
Especifica a lista de testes, conforme especificado no arquivo de metadados, a ser executada.Para obter mais informações, consulte /testlist. |
/test:[nome de teste] |
Especifica o nome de um teste a ser executado.Para obter mais informações, consulte /test . |
/noisolation |
Execute testes dentro do processo MSTest.exe.Essa opção melhora a velocidade de execução de teste, mas aumenta o risco para o processo MSTest.exe. |
/runconfig:[Nome do Arquivo] |
Usa o arquivo de configuração de execução especificado. Exemplo: /runconfig:localtestrun.Testrunconfig Para obter mais informações, consulte /runconfig. .gif "Observação") Observação:
W uando dispositivo inteligente executando testes de unidade, você deve especificar a opção/runconfig.
|
/resultsfile:[Nome do Arquivo] |
Salva os resultados da execução do teste para o arquivo especificado. Exemplo: /resultsfile:testResults.trx Para obter mais informações, consulte /resultsfile. |
/unique |
Executar o teste somente se for encontrada uma correspondência exclusiva para qualquer especificado /test. Para obter mais informações, consulte /unique. |
/detail:[id de propriedade] |
Especifica o nome de uma propriedade, cujos valores se deseje mostrar, caso existam, juntamente com o resultado de teste.Para obter mais informações, consulte /detail. |
/help |
Exibe a mensagem de uso do MSTest.exe (forma abreviada: /? ou /h). |
/nologo |
Não exibe nenhuma faixa inicialização nem mensagem de direitos autorais. |
Opções de Linha de Comando para Publicação dos Resultados de Testes
Para obter mais informações sobre essas opções, consulte Opções de Linha de Comando para Publicação dos Resultados de Testes.
/publish:[nome do servidor] |
Publica resultados para o armazenamento operacional do servidor especificado. |
/publishresultsfile:[Nome do Arquivo] |
Especifica o nome do arquivo de resultados a ser publicado.Se nenhum nome de arquivo de resultados for especificado, usa o arquivo produzido pela execução atual. |
/publishbuild:[Criar id] |
Publica resultados de teste usando a identificação desta compilação. |
/teamproject:[nome do projeto da equipe] |
Especifica o nome do projeto da equipe ao qual pertence a compilação. |
/platform:[plataforma] |
Especifica a plataforma da compilação na qual devem ser publicados os resultados do teste. |
/flavor:[tipo] |
Especifica o tipo da compilação na qual devem ser publicados resultados do teste. |
Usando Opções MSTest
As seções a seguir descrevem muitas das opções para MSTest.exe com mais detalhes.As opções usadas para publicação teste resultados não estão incluídos aqui; para obter informações sobre essas opções, consulte Opções de Linha de Comando para Publicação dos Resultados de Testes.
/testcontainer
/testcontainer:[Nome do Arquivo]
O contêiner de teste é um arquivo que contém os testes que você deseja executar.Por exemplo, para testes ordenados, o contêiner de teste é o arquivo .orderedtest que define o teste ordenado.Para testes de unidade, ele é o assembly compilado a partir o projeto do teste que contém os arquivos de origem do teste de unidade.
| Observação: |
|---|
Para testes de unidade, este é o assembly que contém código de teste, não o assembly que contém o código do aplicativo que você está testando.Por exemplo, se sua solução contiver um projeto denominado BankAccount e um projeto de teste correspondente chamado BankAccountTest, especificar /testcontainer:BankAccountTest.dll. |
Devi ao fato do assembly de teste conter os testes para um projeto de teste, o número de contêiners de teste para uma solução coincide com o número de projetos de teste na solução.
| Observação: |
|---|
Porque o arquivo de metadados de teste também listar os testes que podem ser executados, você não deve especificar ambas as /testcontainer e /testmetadata opções em uma única linha de comando. Fazer isso poderia gerar ambiguidade e produzir um erro. |
/testmetadata
/testmetadata:[Nome do Arquivo]
Você pode usar o /testmetadata opção para executar testes em vários contêiners de teste.
O arquivo de metadados de teste é criado para sua solução quando você criar listas de teste usando a janela do Editor de Lista de Testes.Este arquivo contém informações sobre todos os testes listados na janela Editor de Lista de Testes.Esses são todos os testes que existem em todos os projetos de testes em sua solução.
Você pode alterar o arquivo de metadados de teste somente fazendo alterações são refletidas na janela Editor de Lista de Testes, sistema autônomo, por exemplo, criar ou excluir testes ou alterar propriedades do teste.
| Observação: |
|---|
Como o contêiner de teste contém testes que você pode executar, você não deve especificar ambas as /testcontainer e /testmetadata opções em uma única linha de comando. Fazer isso poderia gerar ambiguidade e produzir um erro. |
O arquivo de metadados do teste é um arquivo XML que é criado na pasta da solução.Este arquivo é mostrado no Solution Explorer sob o nó Solution Items.Um arquivo de metadados de teste possui a extensão .vsmdi e está associado à janela Editor de Lista de Testes; ou seja, se você clicar duas vezes em um arquivo .vsmdi no Windows Explorer, o arquivo abre o Visual Studioe seu Sumário. Todos os testes em projetos de teste da solução são exibidos na janela Editor de Lista de Testes.
Quando você usa o /testmetadata opção, é recomendável que você indique testes específicos para executar usando o /test opção ou o /testlist opção ou ambos.
/testlist
/testlist:[caminho da lista de testes]
The**/testlist**option is a list of tests, as specified in the test metadata file, to be run.Para executar os testes contidos em várias listas de teste, use o /testlist opção várias vezes.
| Observação: |
|---|
Você pode usar o /testlist opção somente se você também usar o /testmetadata opção. |
Você pode usar o /testlist opção e o /test opção juntas. Isso equivale a selecionando uma lista de teste e um ou mais testes individuais na janela Editor de Lista de Testes e, em seguida, clicando em Execute testes.
/Test
/test:[nome de teste]
Use o /test opção para especificar testes individuais para serem executados. Para executar vários testes, utilize o /test opção várias vezes.
| Observação: |
|---|
Você pode usar o /test opção com um a /testcontainer opção ou com o /testmetadata opção, mas não com ambos. |
Você pode usar o /testlist opção e o /test opção juntas. Isso equivale a selecionando uma lista de teste e um ou mais testes individuais na janela Editor de Lista de Testes e, em seguida, clicando em Execute testes.
A seqüência de caracteres que você especificar com a /test opção é usada para corresponder aos nomes de testes em um contêiner de teste ou um arquivo de metadados de teste. Isso significa que você pode especificar vários testes, utilizando um único valor de /test. Por exemplo, especificando /test:ittest deve produzir correspondências para testes denominados DebitTest e CreditTest porque os dois nomes teste contêm a subseqüência de caracteres 'ittest'.
| Observação: |
|---|
O valor especificado com o /test opção é testada e não apenas o nome de teste, mas também o caminho para esse teste, sistema autônomo visto no gerenciador de soluções, ou, com testes de unidade, seu nome totalmente qualificado. |
Segue dois exemplos de uso:
Exemplo de teste de unidade: O arquivo UnitTest1.cs no projeto TestProject2 contém uma unidade de teste chamada TestMethod1.Especificando um valor de 'ittest' para a opção /test também deve fazer correspondência com este teste, porque a sequência de caracteres é verificada com o nome totalmente qualificado "TestProject2.UnitTest1.TestMethod1" e a sequência de caracteres 'ittest' também aparece em 'UnitTest1'.
Exemplo de teste genérico: A seguinte linha de comando executa o teste genérico especificado e, nos resultados do teste exibe o caminho completo para o teste.
mstest /testcontainer:"C:\Documents and Settings\<user name>\My Documents\Visual Studio\Projects\TestProject2\TestProject2\generictest1.generic" /test:testproject32\generic
/noisolation
/noisolation
Use esta opção para executar testes no processo MSTest.exe.Usar esta opção faz com que nenhuma Outros alteração para o execução de teste configuração.A finalidade dessa opção é melhorar a velocidade de execução de teste.No entanto, ele aumenta o risco para a execução sistema autônomo um todo porque uma exceção sem tratamento lançada por código de teste faria com que o processo de MSTest.exe falhar do teste.
/runconfig
/runconfig:[Nome do Arquivo]
Use esta opção para especificar um arquivo de configuração de execução.Por exemplo: /runconfig:localtestrun.Testrunconfig
Você pode especificar um arquivo de configuração de execução de outras maneiras, como com a opção /testmetadata.As regras que governam a especificação de arquivos de configuração de execução são descritos aqui.
Se você usar o /runconfig opção, o arquivo especificado será usado, quer você use ou não a /testmetadata opção.
Se você usar o /testmetadata opção para apontar para um arquivo de metadados que especifica o arquivo de configuração de execução ativo, arquivo de configuração de execução será usada se você não usar o /runconfig opção.
Se você não usar o /runconfig opção e você também não especificar um arquivo de configuração de execução no arquivo de metadados do teste, o tempo de execução de teste usa o arquivo de configuração de execução padrão.
| Observação: |
|---|
Ao executar testes de unidade de dispositivo SMART, você deve especificar a opção/runconfig. |
/resultsfile
/resultsfile:[Nome do Arquivo]
Use esta opção para salvar os resultados do teste executação para o arquivo nomeado.Por exemplo: /resultsfile:testResults.trx.
/unique
/unique
Use o /unique opção em conjunto com o /test opção. The /unique opção instrui MSTest.exe para executar somente um único teste cujo nome corresponde ao valor fornecido com o /test opção.
Por exemplo, o contêiner de teste MyTestProject contém testes denominados MethodTest1 e MethodTest10.
A linha de comando:
mstest /testcontainer:testproject2.dll /test:MethodTest1
executa ambos os testes, MethodTest1 e MethodTest10, pois 'MethodTest1' é uma subsequência de caracteres de 'MethodTest10'.
Mas a linha de comando:
mstest /testcontainer:testproject2.dll /test:MethodTest1 /unique
executa somente o teste MethodTest1.
/detail
/detail:[id de propriedade]
Esta opção é usada para exibir propriedades adicionais de casos de teste, se existirem.Você pode passar mais de uma instância do /detail opção, cada um com id de apenas uma propriedade, em única linha de comando. Id de propriedade válido para o /detail opção a seguir:
adapter |
id |
projectrelativepath |
computername |
isautomated |
readonly |
debugtrace |
link |
spoolmessage |
description |
longtext |
stderr |
displaytext |
name |
stdout |
duration |
outcometext |
storage |
errormessage |
owner |
testcategoryid |
errorstacktrace |
parentexecid |
testname |
executionid |
priority |
testtype |
groups |
projectname |
traceinfo |
| Observação: |
|---|
A seleção real de identificadores de propriedades (property IDs) que você pode usar com a opção /detail varia de acordo com tipo de teste.Portanto, esta lista é somente uma aproximação.Em particular, se você estiver usando o teste tipos além daqueles que estão incluídos na Ferramentas de teste do Team System, a seleção de propriedades será diferente. Para saber quais identificadores de propriedades você pode usar, examine o arquivo de resultados de teste produzido pela execução de teste.Para obter mais informações sobre arquivos de resultados de teste, consulte Como: Exportar resultados de teste. |
Se uma propriedade existir para um caso de teste especificado, suas informações será incluído resumo de resultado de saída.
Por exemplo, a linha de comando:
mstest /testcontainer:Errors.dll /detail:testtype
produz a saída a seguir, que contém informações do tipo de teste:
...Results Top Level Tests-------- -----------------Inconclusive TestProject2.BankAccountTest.CreditTest[testtype] = Unit Test...