Regole di utilizzo di MSTest

Le regole di utilizzo supportano l'uso corretto di attributi, metodi e modelli MSTest. Queste regole rilevano errori comuni e assicurano che i test seguano i requisiti e le convenzioni del framework.

Regole in questa categoria

* Elevato a Errore nelle modalità Recommended e All.

Scenari comuni

Convalida della struttura di test

Verificare che le classi, i metodi e le fixture di test siano conformi ai requisiti MSTest:

• MSTEST0002: requisiti di layout della classe di test (ad esempio, pubblico, non statico).
• MSTEST0003: requisiti di struttura del metodo di test (elevati a Errore).
• MSTEST0030: i metodi con [TestMethod] devono trovarsi in [TestClass].
• MSTEST0063: convalida del costruttore della classe di test.
• MSTEST0069: applica direttamente [TestClass] in modo che l'individuazione generata dall'origine trovi la classe .
• MSTEST0082: mantenere le classi di test di base e derivate nella stessa versione principale di MSTest.

Metodi relativi al ciclo di vita

Convalidare i metodi di inizializzazione e pulizia:

• MSTEST0008: Convalida di TestInitialize.
• MSTEST0009: Validazione TestCleanup.
• MSTEST0010: ClasseInitialize convalida.
• MSTEST0011: validazione ClassCleanup.
• MSTEST0012: Validazione di AssemblyInitialize.
• MSTEST0013: convalida assemblyCleanup.
• MSTEST0034: Impostare il ClassCleanupBehavior.EndOfClass.
• MSTEST0050: convalida della fixture di test globale.
• MSTEST0072: non usare provider di fixture di assembly condivisi con compilazione anticipata.
• MSTEST0082: ricompilare i metodi del ciclo di vita ereditati rispetto alla versione MSTest del progetto di test.

Test basati sui dati

Verificare che gli attributi dei dati vengano usati correttamente:

• MSTEST0007: Gli attributi dei dati devono essere applicati ai metodi di test.
• MSTEST0014: convalida di DataRow.
• MSTEST0018: convalida DynamicData.
• MSTEST0042: rilevare righe di dati duplicate.
• MSTEST0052: usare AutoDetect per DynamicDataSourceType.
• MSTEST0062: Evitare l'uso dei parametri out/ref.

Scrittura di asserzioni migliori

Regole per l'utilizzo corretto ed efficace delle asserzioni:

• MSTEST0017: passare il valore previsto/effettivo nell'ordine corretto.
• MSTEST0023: non negare le condizioni (usare direttamente Assert.IsFalse).
• MSTEST0026: evitare operatori condizionali null nelle asserzioni.
• MSTEST0032: esaminare le condizioni invariabilmente vere.
• MSTEST0037: usare il metodo assert più appropriato.
• MSTEST0038: non usare AreSame con i tipi valore.
• MSTEST0039: usare Assert.ThrowsExactly (API più recente).
• MSTEST0046: Utilizzare Assert invece di StringAssert.
• MSTEST0051: Assert.Throws deve testare una singola istruzione.
• MSTEST0053: usare l'interpolazione di stringhe anziché i parametri di formato.
• MSTEST0058: non inserire le asserzioni in blocchi catch.
• MSTEST0064: Preferire i metodi di asserzione asincroni invece di bloccare il codice asincrono.
• MSTEST0065: Evitare Assert.AreEqual sui tipi di raccolta.
• MSTEST0068: preferisce Assert rispetto a CollectionAssert.

Utilizzo di TestContext

Utilizzo corretto dell'oggetto TestContext:

• MSTEST0005: convalida delle proprietà TestContext.
• MSTEST0024: non archiviare TestContext in campi statici.
• MSTEST0048: accesso limitato alle proprietà nelle fixture.
• MSTEST0049: token di annullamento del flusso da TestContext.
• MSTEST0054: usare la proprietà TestContext.CancellationToken.

Modelli asincroni

Regole per il codice di test asincrono:

• MSTEST0040: evitare asserzioni nei metodi void asincroni.
• MSTEST0067: evitare Thread.Sleep, Task.Waite altre chiamate di blocco sincrono nel codice di test (consenso esplicito).

Sicurezza dei test paralleli

Regole per i test eseguiti in parallelo:

• MSTEST0073: usare costanti condivise per le chiavi di blocco delle risorse.
• MSTEST0074: blocca le mutazioni allo stato globale del processo.
• MSTEST0075: blocca le modifiche della directory corrente.
• MSTEST0076: Evitare modifiche delle impostazioni cultura a livello di processo.
• MSTEST0077: evitare percorsi di file system condivisi.

Configurazione di test

• MSTEST0031: usare gli attributi appropriati (non System.ComponentModel.Description).
• MSTEST0035: utilizzo di DeploymentItem.
• MSTEST0041: gli attributi della condizione devono essere nelle classi di test.
• MSTEST0043: gli attributi di retry devono essere presenti nei metodi di test (⚠️ escalato a Errore).
• MSTEST0055: non ignorare i valori restituiti dal metodo stringa.
• MSTEST0056: impostare DisplayName correttamente in TestMethodAttribute.
• MSTEST0057: Propagare le informazioni di origine nel TestMethodAttribute personalizzato.
• MSTEST0059: non usare sia Parallelize che DoNotParallelize.
• MSTEST0060: evitare TestMethodAttribute duplicati.
• MSTEST0061: usare l'attributo OSCondition per i controlli della piattaforma.
• MSTEST0070: [MemberCondition] gli argomenti devono fare riferimento a membri validi.
• MSTEST0071: non impostare un nome visualizzato uguale al nome del metodo di test.
• MSTEST0078: Convalida i target [DependsOn] e i grafi delle dipendenze.
• MSTEST0079: usare ArchitectureCondition anziché i controlli dell'architettura di runtime.
• MSTEST0080: usare CICondition anziché i controlli dell'ambiente.
• MSTEST0081: convalidare le registrazioni del provider di filtri di test.
• MSTEST0082: rilevare i test ereditati e i metodi del ciclo di vita compilati in base a un'altra versione principale di MSTest.
• MSTEST0083: usare ExecutableCondition anziché un controllo eseguibile imperativo.

Documentazione correlata

• Scrivere test con MSTest
• Asserzioni
• Ciclo di vita
• Testcontext