Informazioni di riferimento sulle opzioni dell'interfaccia della riga di comando di Microsoft.Testing.Platform

Questo articolo fornisce un punto di ingresso centrale per le opzioni della riga di comando Microsoft.Testing.Platform.

Opzioni della piattaforma

@

Specifica il nome del file di risposta. Il nome del file di risposta deve seguire immediatamente il @ carattere senza spazi vuoti tra il @ carattere e il nome del file di risposta.

Le opzioni in un file di risposta vengono interpretate come se fossero presenti in tale posizione nella riga di comando. Non è possibile usare il carattere barra rovesciata \ per concatenare le righe. L'uso di un file di risposta consente di eseguire comandi molto lunghi che potrebbero superare i limiti del terminale. È possibile combinare un file di risposta con argomenti della riga di comando inline. Per esempio:
```
./TestExecutable.exe @"filter.rsp" --timeout 10s
```
dove filter.rsp può avere il contenuto seguente:
```
--filter "A very long filter"
```
In alternativa, è possibile usare un singolo file rsp per specificare sia il timeout che il filtro come indicato di seguito:
```
./TestExecutable.exe @"arguments.rsp"
```
```
--filter "A very long filter" --timeout 10s
```
Annotazioni

Quando si usa dotnet test, il parser della riga di comando dell'SDK usa un approccio token per riga in cui ogni riga nel file di risposta viene considerata come un singolo token. In tal caso, ogni argomento deve trovarsi in una riga separata:
```
--filter
A very long filter
--timeout
10s
```
--config-file

Specifica un file testconfig.json.
--diagnostic

Abilita la registrazione diagnostica. Il livello di log predefinito è Trace. Il file viene scritto nella directory di output con il formato del nome seguente, log_[MMddHHssfff].diag.
--diagnostic-synchronous-write

Forza il logger di file predefinito a scrivere i log in modo sincrono. Utile per le situazioni in cui non si vogliono perdere registrazioni di log (se il processo si arresta in modo anomalo). Ciò rallenta l'esecuzione del test.
--diagnostic-output-directory

La directory di output per la registrazione diagnostica, se non specificata, è generata nella directory predefinita TestResults.
--diagnostic-file-prefix

Prefisso per il nome del file di log. Il valore predefinito è "log".
--diagnostic-verbosity

Definisce il livello di verbosità quando viene utilizzato l'interruttore --diagnostic. I valori disponibili sono Trace, Debug, Information, Warning, Erroro Critical.
--exit-on-process-exit

Uscire dal processo di test se il processo dipendente esce. È necessario specificare il PID.
--help

Stampa una descrizione di come usare il comando .
--ignore-exit-code

Consente di ignorare alcuni codici di uscita diversi da zero e restituiti come 0. Per altre informazioni, vedere Ignorare i codici di uscita specifici.
--info

Visualizza informazioni avanzate sull'applicazione di test .NET, ad esempio:
- La piattaforma.
- Ambiente.
- Ogni provider registrato della riga di comando, come name, version, descriptione options.
- Ogni strumento registrato, come il relativo command, name, version, descriptione tutti i provider della riga di comando.
Questa funzionalità viene usata per comprendere le estensioni che registrano la stessa opzione della riga di comando o le modifiche nelle opzioni disponibili tra più versioni di un'estensione (o la piattaforma).
--list-tests

Elencare i test disponibili. I test non verranno eseguiti.
--maximum-failed-tests

Specifica il numero massimo di errori di test che, quando raggiunto, arresterà l'esecuzione del test. Il supporto per questa opzione richiede agli autori del framework di implementare la funzionalità di IGracefulStopTestExecutionCapability. Il codice di uscita quando raggiunge tale quantità di errori di test è 13. Per altre informazioni, vedere codici di uscita di Microsoft.Testing.Platform.

Annotazioni

Questa funzionalità è disponibile in Microsoft.Testing.Platform a partire dalla versione 1.5.
--minimum-expected-tests

Specifica il numero minimo di test che devono essere eseguiti. Per impostazione predefinita, è previsto che venga eseguito almeno un test.
--results-directory

Directory in cui verranno inseriti i risultati del test. Se la directory specificata non esiste, viene creata. Il valore predefinito è TestResults nella directory che contiene l'applicazione di test.
--timeout

Timeout globale di esecuzione del test. Accetta un argomento come stringa nel formato <value>[h|m|s] in cui <value> è di tipo float.

Opzioni di estensione per scenario

Usare la tabella seguente per trovare rapidamente le opzioni di estensione.

Scenario	Documentazione delle funzionalità
Raccogliere copertura del codice	Copertura del codice
Raccogliere dump di crash o blocco	Arresti anomali e dump di blocco
Generare report di test (ad esempio TRX)	Report di prova
Personalizzare l'output del terminale	Output del terminale
Applicare controlli a livello di hosting	Hot Reload
Ripetere i test non superati	riprovare
Eseguire test che usano Microsoft Fakes	Microsoft Fakes
Emettere tracce e metriche OpenTelemetry	OpenTelemetry

Individuare le opzioni nell'app di test

Eseguire il file eseguibile di test con --help per elencare le opzioni disponibili per il set di estensioni corrente.

Per eseguire la diagnostica avanzata dei provider e delle opzioni registrate, utilizzare --info.

Vedere anche

Commenti e suggerimenti

Questa pagina è stata utile?

Last updated on 2026-03-02