CA2211：非常數欄位不應該為可見的

型別名稱	NonConstantFieldsShouldNotBeVisible
CheckId	CA2211
分類	Microsoft.Usage
中斷變更	中斷

原因

公用或保護的靜態欄位既非常數，亦非唯讀。

規則描述

既非常數，亦非唯讀的靜態欄位不是安全執行緒。必須小心控制對這類欄位的存取，而且需要進階的程式設計技巧同步 (Synchronize) 對類別物件的存取。因為這些技巧不易學會和精通，而測試這類物件也有困難度，所以最好能用靜態欄位儲存不會變更的資料。此規則可套用到程式庫，但應用程式不應公開 (Expose) 任何欄位。

如何修正違規

若要修正此規則的違規情形，請將靜態欄位設為常數或唯讀。如果無法這麼做，請將型別重新設計為使用替代機制，例如管理基礎欄位之安全執行緒存取的安全執行緒屬性。請注意，如鎖定爭用和死結 (Deadlock) 這類的問題可能會影響程式庫的效能和行為。

隱藏警告的時機

如果您正在開發應用程式，因此對包含靜態欄位之型別的存取具有完全控制，則可以放心地隱藏此規則的警告。使用非常數的靜態欄位會使程式開發人員難以正確使用程式庫，因此程式庫設計工具不應該隱藏此規則的警告。

範例

下列範例顯示違反此規則的型別。

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;
   }
}