CA2211: Los campos no constantes no deben ser visibles
TypeName |
NonConstantFieldsShouldNotBeVisible |
Identificador de comprobación |
CA2211 |
Categoría |
Microsoft.Usage |
Cambio problemático |
Problemático |
Motivo
Un campo estático público o protegido no es constante ni es de sólo lectura.
Descripción de la regla
Los campos estáticos que no son constantes ni de sólo lectura no son seguros para subprocesos.Obtener acceso a este tipo de campo se debe controlar cuidadosamente y requiere técnicas de programación avanzadas para sincronizar el acceso al objeto de clase.Puesto que hay aspectos difíciles de aprender, y comprobar un objeto tiene sus propias dificultades, es mejor utilizar los campos estáticos para los datos de almacén que no cambian.Esta regla se aplica a las bibliotecas; las aplicaciones no deben exponer ningún campo.
Cómo corregir infracciones
Para corregir una infracción de esta regla, marque la constante de campo como estática o de sólo lectura.Si no es posible, vuelva a diseñar el tipo utilizando un mecanismo alternativo como una propiedad segura para subprocesos que administra el acceso seguro al campo subyacente.Tenga en cuenta que los problemas como disputa la contención de bloqueo y los interbloqueos podrían afectar al rendimiento y al comportamiento de la biblioteca.
Cuándo suprimir advertencias
Resulta seguro suprimir una advertencia de esta regla si está desarrollando una aplicación y, por tanto, tiene control total sobre el acceso al tipo que contiene el campo estático.Los diseñadores de bibliotecas no deben suprimir ninguna advertencia de esta regla; si se utilizan campos estáticos no constantes puede hacer que los desarrolladores no utilicen la biblioteca correctamente.
Ejemplo
El siguiente ejemplo muestra un tipo que infringe esta regla.
Imports System
Namespace UsageLibrary
Public Class SomeStaticFields
' Violates rule: AvoidNonConstantStatic;
' the field is public and not a literal.
Public Shared publicField As DateTime = DateTime.Now
' Satisfies rule: AvoidNonConstantStatic.
Public Shared ReadOnly literalField As DateTime = DateTime.Now
' Satisfies rule: NonConstantFieldsShouldNotBeVisible;
' the field is private.
Private Shared privateField As DateTime = DateTime.Now
End Class
End Namespace
using System;
namespace UsageLibrary
{
public class SomeStaticFields
{
// Violates rule: AvoidNonConstantStatic;
// the field is public and not a literal.
static public DateTime publicField = DateTime.Now;
// Satisfies rule: AvoidNonConstantStatic.
public static readonly DateTime literalField = DateTime.Now;
// Satisfies rule: NonConstantFieldsShouldNotBeVisible;
// the field is private.
static DateTime privateField = DateTime.Now;
}
}