Bagikan melalui

CA1000: Jangan deklarasikan anggota statis pada jenis generik

  • Artikel
Properti Nilai
ID Aturan CA1000
Judul Jangan mendeklarasikan anggota statik pada jenis generik
Golongan Desain
Perbaikan bersifat disruptif atau non-disruptif Merusak
Diaktifkan secara default di .NET 8 Tidak

Penyebab

Jenis generik berisi static anggota (Shared di Visual Basic).

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

Deskripsi aturan

static Ketika anggota jenis generik dipanggil, argumen jenis harus ditentukan untuk jenis tersebut. Ketika anggota instans generik yang tidak mendukung inferensi dipanggil, argumen jenis harus ditentukan untuk anggota tersebut. Sintaks untuk menentukan argumen jenis dalam dua kasus ini berbeda dan mudah dikacaukan, seperti yang ditunjukkan oleh panggilan berikut:

' Shared method in a generic type.
GenericType(Of Integer).SharedMethod()

' Generic instance method that does not support inference.
someObject.GenericMethod(Of Integer)()

// Static method in a generic type.
GenericType<int>.StaticMethod();

// Generic instance method that does not support inference.
someObject.GenericMethod<int>();

Umumnya, kedua deklarasi sebelumnya harus dihindari sehingga argumen jenis tidak harus ditentukan ketika anggota dipanggil. Ini menghasilkan sintaks untuk memanggil anggota dalam generik yang tidak berbeda dari sintaks untuk non-generik.

Cara memperbaiki pelanggaran

Untuk memperbaiki pelanggaran aturan ini, hapus anggota statis atau ubah menjadi anggota instans.

Kapan harus menekan peringatan

Jangan menyembunyikan peringatan dari aturan ini. Menyediakan generik dalam sintaks yang mudah dipahami dan digunakan mengurangi waktu yang diperlukan untuk mempelajari dan meningkatkan tingkat adopsi pustaka baru.

Menyembunyikan peringatan

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

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

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

[*.{cs,vb}]
dotnet_diagnostic.CA1000.severity = none

Untuk informasi selengkapnya, lihat Cara menyembunyikan peringatan analisis kode.

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 (Desain) 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

Baca juga