CA1016: Marcar los ensamblados con AssemblyVersionAttribute

  • Artículo
Propiedad Value
Identificador de la regla CA1016
Título Marcar los ensamblados con AssemblyVersionAttribute
Categoría Diseño
La corrección es problemática o no problemática Poco problemático
Habilitado de forma predeterminada en .NET 8 Como sugerencia

Causa

El ensamblado no tiene un número de versión.

Descripción de la regla

La identidad de un ensamblado se compone de la siguiente información:

  • Nombre del ensamblado

  • Número de versión

  • Referencia cultural

  • Clave pública (para ensamblados con nombre seguro).

.NET utiliza el número de versión para identificar de forma única un ensamblado y para enlazarse a los tipos de ensamblados con nombre seguro. El número de versión se utiliza junto con la versión y la directiva del fabricante. De forma predeterminada, las aplicaciones sólo se ejecutan con la versión de ensamblado con la que se compilaron.

Cómo corregir infracciones

Para corregir una infracción de esta regla, agregue un número de versión al ensamblado mediante el atributo System.Reflection.AssemblyVersionAttribute.

Cuándo suprimir las advertencias

No suprima una advertencia de esta regla para los ensamblados utilizados por terceros o que se usan en un entorno de producción.

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 CA1016
// The code that's violating the rule is on this line.
#pragma warning restore CA1016

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.CA1016.severity = none

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

Ejemplo

En el ejemplo siguiente se muestra un ensamblado que tiene aplicado el atributo AssemblyVersionAttribute.

using System;
using System.Reflection;

[assembly: AssemblyVersionAttribute("4.3.2.1")]
namespace DesignLibrary {}

<Assembly: AssemblyVersionAttribute("4.3.2.1")>
Namespace DesignLibrary
End Namespace

Vea también