這和我喜好設定（IDE0003和IDE0009）

發行項
05/07/2024

本文說明兩個相關規則和 IDE0003 IDE0009。

屬性	值
規則識別碼	IDE0003
職稱	拿掉`this`或`Me`限定性
類別	樣式
子類別	語言規則（'this.' 和 'Me.' 限定符）
適用語言	C# 和 Visual Basic
選項	`dotnet_style_qualification_for_field`
	`dotnet_style_qualification_for_property`
	`dotnet_style_qualification_for_method`
	`dotnet_style_qualification_for_event`

屬性	值
規則識別碼	IDE0009
職稱	新增`this`或`Me`限定性
類別	樣式
子類別	語言規則（'this.' 和 'Me.' 限定符）
適用語言	C# 和 Visual Basic
選項	`dotnet_style_qualification_for_field`
	`dotnet_style_qualification_for_property`
	`dotnet_style_qualification_for_method`
	`dotnet_style_qualification_for_event`

概觀

這兩個規則會定義您是否偏好使用這個（C#）和 Me. （Visual Basic）限定符。若要強制限定符 不存在 ，請將的 IDE0003 嚴重性設定為警告或錯誤。若要強制限定符存在，請將的 IDE0009 嚴重性設定為警告或錯誤。

例如，如果您偏好欄位和屬性的限定元，而不是方法或事件，則可以啟用 IDE0009 並設定選項 dotnet_style_qualification_for_field ，並將設定 dotnet_style_qualification_for_property 為 true。不過，此組態不會標記具有 this 和限定符的方法和Me事件。若要同時強制執行該方法和事件沒有限定符，請啟用 IDE0003。

注意

即使您在建置時啟用程式代碼樣式規則，也不會啟用此規則。它只會出現在 Visual Studio 編輯器中。

選項。

此規則的相關選項會定義應該套用此樣式喜好設定的下列哪一個符號：

欄位（dotnet_style_qualification_for_field）
屬性（dotnet_style_qualification_for_property）
方法（dotnet_style_qualification_for_method）
事件（dotnet_style_qualification_for_event）

選項值表示true偏好在 C# 和 Me. Visual Basic 中前面加上程式代碼符號this.。選項值false表示偏好程式代碼專案不要以或 Me.開頭this.。

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

dotnet_style_qualification_for_field

屬性	數值	Description
選項名稱	dotnet_style_qualification_for_field
選項值	`true`	偏好在 C# 或 `Me.` Visual Basic 中以前面加上`this.`欄位
	`false`	偏好不要以或開頭`this.`欄位`Me.`
默認選項值	`false`

// dotnet_style_qualification_for_field = true
this.capacity = 0;

// dotnet_style_qualification_for_field = false
capacity = 0;

' dotnet_style_qualification_for_field = true
Me.capacity = 0

' dotnet_style_qualification_for_field = false
capacity = 0

dotnet_style_qualification_for_property

屬性	數值	Description
選項名稱	dotnet_style_qualification_for_property
選項值	`true`	偏好在 C# 或 `Me.` Visual Basic 中以前面加上`this.`屬性。
	`false`	偏好屬性不要以或 `Me.`開頭`this.`。
默認選項值	`false`

// dotnet_style_qualification_for_property = true
this.ID = 0;

// dotnet_style_qualification_for_property = false
ID = 0;

' dotnet_style_qualification_for_property = true
Me.ID = 0

' dotnet_style_qualification_for_property = false
ID = 0

dotnet_style_qualification_for_method

屬性	數值	Description
選項名稱	dotnet_style_qualification_for_method
選項值	`true`	偏好在 C# 或 `Me.` Visual Basic 中以開頭`this.`的方法。
	`false`	偏好方法不要以或 `Me.`開頭`this.`。
默認選項值	`false`

// dotnet_style_qualification_for_method = true
this.Display();

// dotnet_style_qualification_for_method = false
Display();

' dotnet_style_qualification_for_method = true
Me.Display()

' dotnet_style_qualification_for_method = false
Display()

dotnet_style_qualification_for_event

屬性	數值	Description
選項名稱	dotnet_style_qualification_for_event
選項值	`true`	偏好在 C# 或 `Me.` Visual Basic 中使用開頭`this.`的事件。
	`false`	偏好事件不要以或 `Me.`開頭`this.`。
默認選項值	`false`

// dotnet_style_qualification_for_event = true
this.Elapsed += Handler;

// dotnet_style_qualification_for_event = false
Elapsed += Handler;

' dotnet_style_qualification_for_event = true
AddHandler Me.Elapsed, AddressOf Handler

' dotnet_style_qualification_for_event = false
AddHandler Elapsed, AddressOf Handler

隱藏警告

如果您想要只隱藏單一違規，請將預處理器指示詞新增至原始程式檔以停用，然後重新啟用規則。

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

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

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

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

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

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

共用方式為