Bagikan melalui

CA2226: Operator harus memiliki overload simetris

  • Artikel
Properti Nilai
ID Aturan CA2226
Judul Operator harus memiliki kelebihan beban simetris
Golongan Penggunaan
Perbaikan bersifat disruptif atau non-disruptif Non-disruptif
Diaktifkan secara default di .NET 8 Tidak

Penyebab

Jenis menerapkan operator kesetaraan atau ketidaksetaraan dan tidak menerapkan operator yang berlawanan.

Secara default, aturan ini hanya melihat jenis yang terlihat secara eksternal, tetapi ini dapat dikonfigurasi.

Deskripsi aturan

Tidak ada keadaan di mana kesetaraan atau ketidaksetaraan berlaku untuk instans jenis, dan operator yang berlawanan tidak ditentukan. Jenis biasanya mengimplementasikan operator ketidaksetaraan dengan mengembalikan nilai operator kesetaraan yang dinegasikan.

Pengkompilasi C# mengeluarkan kesalahan untuk pelanggaran aturan ini.

Cara memperbaiki pelanggaran

Untuk memperbaiki pelanggaran aturan ini, terapkan operator kesetaraan dan ketidaksetaraan, atau hapus yang ada.

Kapan harus menekan peringatan

Jangan menyembunyikan peringatan dari aturan ini. Jika Anda melakukannya, jenis Anda tidak akan berfungsi dengan cara yang konsisten dengan .NET.

Mengonfigurasi kode yang akan dianalisis

Gunakan opsi berikut untuk mengonfigurasi bagian mana dari codebase Anda yang akan menjalankan aturan ini.

Anda dapat mengonfigurasi opsi ini hanya untuk aturan ini, untuk semua aturan yang berlaku untuknya, atau untuk semua aturan dalam kategori ini (Penggunaan) yang diterapkannya. Untuk informasi selengkapnya, lihat Opsi konfigurasi aturan kualitas kode.

Menyertakan permukaan API tertentu

Anda dapat mengonfigurasi bagian mana dari basis kode yang akan menjalankan aturan ini, berdasarkan aksesibilitasnya. Misalnya, untuk menentukan bahwa aturan hanya boleh dijalankan pada permukaan API non-publik, tambahkan pasangan kunci-nilai berikut ke file .editorconfig di proyek Anda:

dotnet_code_quality.CAXXXX.api_surface = private, internal