Gunakan ekspresi koleksi untuk kosong (IDE0301)

Properti	Nilai
ID Aturan	IDE0301
Judul	Gunakan ekspresi koleksi untuk kosong
Golongan	Gaya
Subkategori	Aturan bahasa (preferensi tingkat ekspresi)
Bahasa pemrogram yang berlaku	C# 12+
Opsi	dotnet_style_prefer_collection_expression

Gambaran Umum

Aturan ini mencari kode yang mirip Array.Empty<T>() dengan (panggilan metode yang mengembalikan koleksi kosong) atau ImmutableArray<T>.Empty (properti yang mengembalikan koleksi kosong) dan menawarkan untuk menggantinya dengan ekspresi koleksi ([]).

Opsi

Opsi menentukan perilaku yang Anda inginkan untuk diberlakukan aturan. Untuk informasi tentang mengonfigurasi opsi, lihat Format opsi.

dotnet_style_prefer_collection_expression

Properti	Nilai	Deskripsi
Nama opsi	dotnet_style_prefer_collection_expression
Nilai opsi	true | when_types_exactly_match	Lebih suka menggunakan ekspresi koleksi hanya ketika jenis cocok persis, misalnya, int[] i = Array.Empty<int>();.
	when_types_loosely_match (.NET 9 dan versi yang lebih baru)*	Lebih suka menggunakan ekspresi koleksi bahkan ketika jenis cocok secara longgar, misalnya, IEnumerable<int> i = Array.Empty<int>();. Jenis yang ditargetkan harus cocok dengan jenis di sisi kanan atau menjadi salah satu jenis berikut: IEnumerable<T>, , ICollection<T>, IList<T>IReadOnlyCollection<T>, IReadOnlyList<T>.
	false | never	Menonaktifkan aturan.
Nilai opsi default	true dalam .NET 8 when_types_loosely_match di .NET 9 dan versi yang lebih baru

^*Perbaikan kode saat opsi ini digunakan dapat mengubah semantik kode Anda.

Contoh

// Code with violations.
int[] i = Array.Empty<int>();
IEnumerable<int> j = Array.Empty<int>();
ReadOnlySpan<int> span = ReadOnlySpan<int>.Empty;

// Fixed code.
int[] i = [];
IEnumerable<int> j = [];
ReadOnlySpan<int> span = [];

Cuplikan kode berikut menunjukkan contoh dengan jenis kustom.

public class Program
{
    public static void Main()
    {
        // IDE0301 violation.
        MyList<int> x = MyList<int>.Empty;

        // IDE0301 fixed code.
        MyList<int> x = [];
    }
}

class MyList<T> : IEnumerable<T>
{
    public static MyList<T> Empty { get; }

    public IEnumerator<T> GetEnumerator() => default;
    IEnumerator IEnumerable.GetEnumerator() => default;
}

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 IDE0301
// The code that's violating the rule is on this line.
#pragma warning restore IDE0301

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

[*.{cs,vb}]
dotnet_diagnostic.IDE0301.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.

Baca juga

• Menggunakan ekspresi koleksi untuk array (IDE0300)