新增唯讀修飾元 (IDE0044)

屬性	值
規則識別碼	IDE0044
標題	新增唯讀修飾元
類別	樣式
子類別	語言規則 (欄位喜好設定)
適用語言	C# 和 Visual Basic
引進的版本	Visual Studio 2017
選項	dotnet_style_readonly_field

概觀

對於已初始化 (內嵌或在建構函式內部) 但從未重新指派的私用欄位，此樣式規則會考慮指定 readonly (C#) 或 ReadOnly (Visual Basic) 修飾元。

選項

選項會指定您想要強制執行規則的行為。 如需設定選項的資訊，請參閱選項格式。

dotnet_style_readonly_field

屬性	值	描述
選項名稱	dotnet_style_readonly_field
選項值	true	最好將私用欄位標記為 readonly (如果它們只是內嵌或在建構函式中指派的話)
	false	指定不優先考慮私用欄位是否標記為 readonly
預設選項值	true

// dotnet_style_readonly_field = true
class MyClass
{
    private readonly int _daysInYear = 365;
}

' dotnet_style_readonly_field = true
Public Class MyClass
    Private ReadOnly daysInYear As Int = 365
End Class

隱藏警告

若您只想隱藏單一違規，請將前置處理指示詞新增至來源檔案以停用規則，然後重新啟用規則。

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

若要停用檔案、資料夾或專案的規則，請在組態檔中將其嚴重性設定為 none。

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

若要停用所有程式碼樣式規則，請在組態檔中將類別 Style 的嚴重性設定為 none。

[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Style.severity = none

如需詳細資訊，請參閱如何隱藏程式碼分析警告。

另請參閱

• 程式碼樣式語言規則
• 程式碼樣式規則參考