Ini dan preferensi Saya (IDE0003 dan IDE0009)

Artikel
05/07/2024

Artikel ini menjelaskan dua aturan terkait, IDE0003 dan IDE0009.

Properti	Nilai
ID Aturan	IDE0003
Judul	Hapus `this` atau `Me` kualifikasi
Golongan	Gaya
Subkategori	Aturan bahasa ('this.' dan 'Me.' qualifiers)
Bahasa pemrogram yang berlaku	C# dan Visual Basic
Opsi	`dotnet_style_qualification_for_field`
	`dotnet_style_qualification_for_property`
	`dotnet_style_qualification_for_method`
	`dotnet_style_qualification_for_event`

Properti	Nilai
ID Aturan	IDE0009
Judul	Tambahkan `this` atau `Me` kualifikasi
Golongan	Gaya
Subkategori	Aturan bahasa ('this.' dan 'Me.' qualifiers)
Bahasa pemrogram yang berlaku	C# dan Visual Basic
Opsi	`dotnet_style_qualification_for_field`
	`dotnet_style_qualification_for_property`
	`dotnet_style_qualification_for_method`
	`dotnet_style_qualification_for_event`

Gambaran Umum

Kedua aturan ini menentukan apakah Anda lebih suka menggunakan kualifikasi (C#) dan Me. (Visual Basic) ini atau tidak. Untuk memberlakukan bahwa kualifikasi tidak ada, atur tingkat keparahan IDE0003 ke peringatan atau kesalahan. Untuk memberlakukan bahwa kualifikasi ada , atur tingkat keparahan IDE0009 ke peringatan atau kesalahan.

Misalnya, jika Anda lebih suka kualifikasi untuk bidang dan properti tetapi tidak untuk metode atau peristiwa, maka Anda dapat mengaktifkan IDE0009 dan mengatur opsi dotnet_style_qualification_for_field dan dotnet_style_qualification_for_property ke true. Namun, konfigurasi ini tidak akan menandai metode dan peristiwa yang memiliki this dan Me kualifikasi. Untuk juga memberlakukan bahwa metode dan peristiwa tidak memiliki kualifikasi, aktifkan IDE0003.

Catatan

Bahkan jika Anda mengaktifkan aturan gaya kode pada build, aturan ini tidak diaktifkan. Ini hanya muncul di editor Visual Studio.

Opsi

Opsi terkait aturan ini menentukan simbol mana dari simbol berikut yang harus diterapkan pada preferensi gaya ini:

Bidang (dotnet_style_qualification_for_field)
Properti (dotnet_style_qualification_for_property)
Metode (dotnet_style_qualification_for_method)
Peristiwa (dotnet_style_qualification_for_event)

Nilai opsi berarti true lebih memilih simbol kode yang akan diawali dengan this. di C# dan Me. di Visual Basic. Nilai opsi dari false berarti lebih memilih elemen kode untuk tidak diawali dengan this. atau Me..

Untuk informasi selengkapnya tentang mengonfigurasi opsi, lihat Format opsi.

dotnet_style_qualification_for_field

Properti	Nilai	Deskripsi
Nama opsi	dotnet_style_qualification_for_field
Nilai opsi	`true`	Lebih suka bidang yang akan diawali dengan `this.` di C# atau `Me.` di Visual Basic
	`false`	Lebih suka bidang yang tidak diawali dengan `this.` atau `Me.`
Nilai opsi default	`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

Properti	Nilai	Deskripsi
Nama opsi	dotnet_style_qualification_for_property
Nilai opsi	`true`	Lebih suka properti yang akan diawali dengan `this.` di C# atau `Me.` di Visual Basic.
	`false`	Lebih suka properti yang tidak diawali dengan `this.` atau `Me.`.
Nilai opsi default	`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

Properti	Nilai	Deskripsi
Nama opsi	dotnet_style_qualification_for_method
Nilai opsi	`true`	Lebih suka metode yang akan diawali dengan `this.` C# atau `Me.` di Visual Basic.
	`false`	Lebih suka metode yang tidak diawali dengan `this.` atau `Me.`.
Nilai opsi default	`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

Properti	Nilai	Deskripsi
Nama opsi	dotnet_style_qualification_for_event
Nilai opsi	`true`	Lebih suka peristiwa yang akan diawali dengan `this.` di C# atau `Me.` di Visual Basic.
	`false`	Lebih suka peristiwa yang tidak diawali dengan `this.` atau `Me.`.
Nilai opsi default	`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

Menyembunyikan peringatan

Jika Anda hanya ingin menekan satu pelanggaran, tambahkan arahan prapemroseduran ke file sumber Anda untuk menonaktifkan lalu mengaktifkan kembali aturan.

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

Untuk menonaktifkan aturan untuk file, folder, atau proyek, atur tingkat keparahannya ke none dalam file konfigurasi.

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

Untuk menonaktifkan semua aturan gaya kode, atur tingkat keparahan none untuk kategori Style ke dalam file konfigurasi.

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

Untuk informasi selengkapnya, lihat Cara menyembunyikan peringatan analisis kode.

Bagikan melalui