Preferensi 'var' (IDE0007 dan IDE0008)

Artikel
06/08/2023

Artikel ini menjelaskan dua aturan terkait, IDE0007 dan IDE0008.

Properti	Nilai
ID Aturan	IDE0007
Judul	Gunakan `var` alih-alih jenis eksplisit
Kategori	Gaya
Subkategori	Aturan bahasa (preferensi 'var')
Bahasa yang berlaku	C#
Opsi	`csharp_style_var_for_built_in_types`
	`csharp_style_var_when_type_is_apparent`
	`csharp_style_var_elsewhere`

Properti	Nilai
ID Aturan	IDE0008
Judul	Gunakan jenis eksplisit alih-alih `var`
Kategori	Gaya
Subkategori	Aturan bahasa (preferensi 'var')
Bahasa yang berlaku	C#
Opsi	`csharp_style_var_for_built_in_types`
	`csharp_style_var_when_type_is_apparent`
	`csharp_style_var_elsewhere`

Gambaran Umum

Kedua aturan gaya ini menentukan apakah kata kunci var atau jenis eksplisit harus digunakan dalam deklarasi variabel. Untuk memberlakukan yang var digunakan, atur tingkat keparahan IDE0007 ke peringatan atau kesalahan. Untuk memberlakukan bahwa jenis eksplisit digunakan, atur tingkat keparahan IDE0008 ke peringatan atau kesalahan.

Opsi

Opsi terkait aturan ini menentukan di mana preferensi gaya ini harus diterapkan:

Jenis bawaan (csharp_style_var_for_built_in_types)
Tempat di mana jenisnya jelas (csharp_style_var_when_type_is_apparent)
Di tempat lain (csharp_style_var_elsewhere)

Untuk informasi selengkapnya tentang mengonfigurasi opsi, lihat Format opsi.

csharp_style_var_for_built_in_types

Properti	Nilai	Deskripsi
Nama opsi	csharp_style_var_for_built_in_types
Nilai opsi	`true`	Prefer `var` digunakan untuk mendeklarasikan variabel dengan jenis sistem bawaan seperti `int`
	`false`	Lebih suka jenis eksplisit daripada `var` untuk mendeklarasikan variabel dengan jenis sistem bawaan seperti `int`
Nilai opsi default	`false`

// csharp_style_var_for_built_in_types = true
var x = 5;

// csharp_style_var_for_built_in_types = false
int x = 5;

csharp_style_var_when_type_is_apparent

Properti	Nilai	Deskripsi
Nama opsi	csharp_style_var_when_type_is_apparent
Nilai opsi	`true`	Lebih suka `var` ketika jenis sudah disebutkan di sisi kanan ekspresi deklarasi
	`false`	Pilih jenis eksplisit ketika jenis sudah disebutkan di sisi kanan ekspresi deklarasi
Nilai opsi default	`false`

// csharp_style_var_when_type_is_apparent = true
var obj = new Customer();

// csharp_style_var_when_type_is_apparent = false
Customer obj = new Customer();

csharp_style_var_elsewhere

Properti	Nilai	Deskripsi
Nama opsi	csharp_style_var_elsewhere
Nilai opsi	`true`	Lebih suka `var` daripada jenis eksplisit dalam semua kasus, kecuali ditimpa oleh aturan gaya kode lain
	`false`	Lebih suka jenis eksplisit daripada `var` dalam semua kasus, kecuali ditimpa oleh aturan gaya kode lain
Nilai opsi default	`false`

// csharp_style_var_elsewhere = true
var f = this.Init();

// csharp_style_var_elsewhere = false
bool f = this.Init();

Menyembunyikan peringatan

Jika Anda hanya ingin menekan satu pelanggaran, tambahkan arahan praprosedur ke file sumber Anda untuk dinonaktifkan lalu aktifkan kembali aturan.

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

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

[*.{cs,vb}]
dotnet_diagnostic.IDE0007.severity = none
dotnet_diagnostic.IDE0008.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.

Share via