preferensi ini dan Me (IDE0003 dan IDE0009)

Artikel
06/08/2023

Artikel ini menjelaskan dua aturan terkait, IDE0003 dan IDE0009.

Properti	Nilai
ID Aturan	IDE0003
Judul	Menghapus`this` atau `Me` kualifikasi
Kategori	Gaya
Subkategori	Aturan bahasa ('this.' dan 'Me.' qualifiers)
Bahasa 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	Menambahkan`this` atau `Me` kualifikasi
Kategori	Gaya
Subkategori	Aturan bahasa ('this.' dan 'Me.' qualifiers)
Bahasa 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 memilikithis dan Me kualifikasi. Untuk juga memberlakukan bahwa metode dan peristiwa tidak memiliki kualifikasi, aktifkan IDE0003.

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`	Pilih properti yang akan diawali dengan `this.` di C# atau `Me.` di Visual Basic.
	`false`	Lebih suka properti 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.` di 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`	Pilih peristiwa yang akan diawali dengan `this.` di C# atau `Me.` di Visual Basic.
	`false`	Lebih suka peristiwa 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 direktif pra-prosesor ke file sumber Anda untuk dinonaktifkan lalu aktifkan 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 untuk kategori Stylenone ke dalam file konfigurasi.

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

Untuk informasi selengkapnya, lihat Cara menyembunyikan peringatan analisis kode.