Preferensi 'var' (IDE0007 dan IDE0008)
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 Style
none
ke dalam file konfigurasi.
[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Style.severity = none
Untuk informasi selengkapnya, lihat Cara menyembunyikan peringatan analisis kode.