新增唯讀修飾詞 （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

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

另請參閱

• 程式代碼樣式語言規則
• 程式碼樣式規則指南