Constante não campos não devem estar visíveis
TypeName |
NonConstantFieldsShouldNotBeVisible |
CheckId |
CA2211 |
Category (Categoria) |
Microsoft.uso |
Quebrando alterar |
Quebrando |
Causa
Um campo estático público ou protegido não é constante nem ele é somente leitura.
Descrição da regra
Campos estático que não são constantes nem leitura - apenas não são thread-safe.Acesso a tal campo deve ser controlado com cuidado e requer técnicas de programação avançadas para a sincronização de acesso ao objeto de classe.Como esses são difíceis de habilidades para aprender e mestre e teste de tal objeto apresenta seus próprios desafios, os campos estático são melhor utilizados para armazenar dados que não é alterado.Esta regra se aplica a bibliotecas; aplicativos não devem expor todos os campos.
Como corrigir violações
Para corrigir uma violação dessa regra, verifique o campo estático constante ou somente leitura.Se não for possível, recrie o tipo a ser usado um mecanismo alternativo sistema autônomo uma propriedade do thread-safe que gerencia o acesso de thread-safe ao campo base.Perceba que problemas sistema autônomo contenção de bloquear e deadlocks podem afetar o desempenho e o comportamento da biblioteca.
Quando suprimir avisos
É seguro suprimir um aviso da regra, se você estiver desenvolvendo um aplicativo e, portanto, têm controle total sobre o acesso para o tipo de campo estático.Designers de biblioteca devem eliminar um aviso da regra; usando campos estático não constante pode fazer usando a biblioteca difícil para os desenvolvedores para usar corretamente.
Exemplo
O exemplo a seguir mostra um tipo que violam essa regra.
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;
}
}