在型別參考中使用語言關鍵字替代架構型別名稱 (IDE0049)

屬性	值
規則識別碼	IDE0049
標題	在型別參考中使用語言關鍵字替代架構型別名稱
類別	樣式
子類別	語言規則 (語言關鍵字，而不是架構類型名稱)
適用語言	C# 和 Visual Basic
選項	dotnet_style_predefined_type_for_locals_parameters_members
	dotnet_style_predefined_type_for_member_access

概觀

此規則是在語言關鍵字存在的情況下，使用語言關鍵字來替代架構型別名稱。

選項

使用此規則的相關選項，可將規則套用至：

• 區域變數、方法參數和類別成員 - dotnet_style_predefined_type_for_locals_parameters_members
• 型別成員存取運算式 - dotnet_style_predefined_type_for_member_access

選項值為 true 時，代表型別中若有關鍵字，則以語言關鍵字 (例如 int 或 Integer) 來優先表示型別，而非型別名稱 (例如 Int32)。 值為 false 代表以型別名稱為優先，而非語言關鍵字。

如需瞭解設定選項，請參閱選項格式。

dotnet_style_predefined_type_for_locals_parameters_members

屬性	值	描述
選項名稱	dotnet_style_predefined_type_for_locals_parameters_members
選項值	true	在區域變數、方法參數和類別成員優先採用語言關鍵字
	false	在區域變數、方法參數和類別成員優先採用型別名稱
預設選項值	true

// dotnet_style_predefined_type_for_locals_parameters_members = true
private int _member;

// dotnet_style_predefined_type_for_locals_parameters_members = false
private Int32 _member;

' dotnet_style_predefined_type_for_locals_parameters_members = true
Private _member As Integer

' dotnet_style_predefined_type_for_locals_parameters_members = false
Private _member As Int32

dotnet_style_predefined_type_for_member_access

屬性	值	描述
選項名稱	dotnet_style_predefined_type_for_member_access
選項值	true	在成員存取運算式優先採用語言關鍵字
	false	在成員存取運算式優先採用型別名稱
預設選項值	true

// dotnet_style_predefined_type_for_member_access = true
var local = int.MaxValue;

// dotnet_style_predefined_type_for_member_access = false
var local = Int32.MaxValue;

' dotnet_style_predefined_type_for_member_access = true
Dim local = Integer.MaxValue

' dotnet_style_predefined_type_for_member_access = false
Dim local = Int32.MaxValue

隱藏警告

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

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

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

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

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

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

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

另請參閱

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