Comparteix a través de

MSTEST0026: Evitar el acceso condicional en aserciones

  • Article
Propiedad Value
Identificador de la regla MSTEST0026
Título Evitar el acceso condicional en aserciones
Categoría Uso
La corrección es problemática o no problemática Poco problemático
Habilitado de forma predeterminada Sí (de 3.5 a 3.7). No (a partir de 3.8)
Gravedad predeterminada Información
Introducido en la versión 3.5.0
Hay una corrección de código No

Causa

Esta regla genera un diagnóstico cuando un argumento que contiene un operador condicional null(?.) o ?[] se pasa a los métodos de aserción siguientes:

  • Assert.IsTrue
  • Assert.IsFalse
  • Assert.AreEqual
  • Assert.AreNotEqual
  • Assert.AreSame
  • Assert.AreNotSame
  • CollectionAssert.AreEqual
  • CollectionAssert.AreNotEqual
  • CollectionAssert.AreEquivalent
  • CollectionAssert.AreNotEquivalent
  • CollectionAssert.Contains
  • CollectionAssert.DoesNotContain
  • CollectionAssert.AllItemsAreNotNull
  • CollectionAssert.AllItemsAreUnique
  • CollectionAssert.AllItemsAreInstancesOfType
  • CollectionAssert.IsSubsetOf
  • CollectionAssert.IsNotSubsetOf
  • StringAssert.Contains
  • StringAssert.StartsWith
  • StringAssert.EndsWith
  • StringAssert.Matches
  • StringAssert.DoesNotMatch

Descripción de la regla

El propósito de las aserciones en las pruebas unitarias es comprobar que se cumplen ciertas condiciones. Cuando se usa un operador de acceso condicional en una aserción, presenta una condición adicional que puede o no cumplirse, en función del estado del objeto al que se accede. Esto puede provocar resultados de pruebas incoherentes y hacer que la prueba sea menos clara.

Cómo corregir infracciones

Asegúrese de que los argumentos no contienen (?.) o ?[] cuando se pasan a los métodos de aserción. En su lugar, realice comprobaciones de null antes de realizar la aserción.

Company? company = GetCompany();
Assert.AreEqual("Contoso", company?.Name); // MSTEST0026
StringAssert.Contains(company?.Address, "Brazil"); // MSTEST0026

// Fixed code
Assert.IsNotNull(company);
Assert.AreEqual("Contoso", company.Name);
StringAssert.Contains(company.Address, "Brazil");

Cuándo suprimir las advertencias

No se recomienda suprimir advertencias de esta regla.

Supresión de una advertencia

Si solo quiere suprimir una única infracción, agregue directivas de preprocesador al archivo de origen para deshabilitar y volver a habilitar la regla.

#pragma warning disable MSTEST0026
// The code that's violating the rule is on this line.
#pragma warning restore MSTEST0026

Para deshabilitar la regla de un archivo, una carpeta o un proyecto, establezca su gravedad en none del archivo de configuración.

[*.{cs,vb}]
dotnet_diagnostic.MSTEST0026.severity = none

Para obtener más información, consulte Procedimiento para suprimir advertencias de análisis de código.