順序修飾元 (IDE0036)

屬性	值
規則識別碼	IDE0036
標題	順序修飾元
類別	樣式
子類別	語言規則 (修飾元喜好設定)
適用語言	C# 和 Visual Basic
引進的版本	Visual Studio 2017
選項	csharp_preferred_modifier_order
	visual_basic_preferred_modifier_order

概觀

此規則可讓您強制執行所需的修飾詞排序順序。

• 當您啟用此規則並將相關聯選項設為修飾詞清單時，即會優先使用指定排序。
• 如果未啟用此規則，則無任何特定的修飾詞順序偏好。

選項

此規則的相關聯選項可讓您分別指定 C# 和 Visual Basic 所需的修飾詞順序。

• csharp_preferred_modifier_order
• visual_basic_preferred_modifier_order

如需設定選項的資訊，請參閱選項格式。

csharp_preferred_modifier_order

屬性	值	描述
選項名稱	csharp_preferred_modifier_order
適用語言	C#
選項值	一或多個 C# 修飾詞，例如 public、private 和 protected
預設選項值	public, private, protected, internal, file, static, extern, new, virtual, abstract, sealed, override, readonly, unsafe, required, volatile, async

// csharp_preferred_modifier_order = public,private,protected,internal,file,static,extern,new,virtual,abstract,sealed,override,readonly,unsafe,required,volatile,async
class MyClass
{
    private static readonly int _daysInYear = 365;
}

visual_basic_preferred_modifier_order

屬性	值	描述
選項名稱	visual_basic_preferred_modifier_order
適用語言	Visual Basic
選項值	一或多個 Visual Basic 修飾詞，例如 Partial、Private 和 Public
預設選項值	Partial, Default, Private, Protected, Public, Friend, NotOverridable, Overridable, MustOverride, Overloads, Overrides, MustInherit, NotInheritable, Static, Shared, Shadows, ReadOnly, WriteOnly, Dim, Const, WithEvents, Widening, Narrowing, Custom, Async

' visual_basic_preferred_modifier_order = Partial,Default,Private,Protected,Public,Friend,NotOverridable,Overridable,MustOverride,Overloads,Overrides,MustInherit,NotInheritable,Static,Shared,Shadows,ReadOnly,WriteOnly,Dim,Const,WithEvents,Widening,Narrowing,Custom,Async
Public Class MyClass
    Private Shared ReadOnly daysInYear As Int = 365
End Class

隱藏警告

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

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

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

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

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

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

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

另請參閱

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