Megosztás a következőn keresztül:

CA1708: Az azonosítóknak több esetben kell eltérnie

  • Cikk
Tulajdonság Érték
Szabályazonosító CA1708
Cím Az azonosítóknak a kis- és nagybetűktől eltérőnek kell lennie
Kategória Elnevezés
A javítás kompatibilitástörő vagy nem törik Törés
Alapértelmezés szerint engedélyezve a .NET 8-ban Nem

Ok

Két típus, tag, paraméter vagy teljes névtér neve megegyezik, ha kisbetűssé alakítják őket.

Ez a szabály alapértelmezés szerint csak külsőleg látható típusokat, tagokat és névtereket tekint meg, de ez konfigurálható.

Szabály leírása

A névterek, típusok, tagok és paraméterek azonosítója nem térhet el csak esetenként, mert a közös nyelvi futtatókörnyezetet megcélzott nyelveknek nem kell megkülönböztetniük a kis- és nagybetűket. A Visual Basic például egy széles körben használt kis- és nagybetűket érzéketlen nyelv.

Szabálysértések kijavítása

Válasszon ki egy egyedi nevet, ha a kis- és nagybetűk megkülönböztetése miatt más azonosítókkal van összehasonlítva.

Mikor kell letiltani a figyelmeztetéseket?

Ne tiltsa el a szabály figyelmeztetését. Előfordulhat, hogy a kódtár nem minden elérhető nyelven használható a .NET-ben.

Kód konfigurálása elemzéshez

A következő beállítással konfigurálhatja, hogy a kódbázis mely részein futtassa ezt a szabályt.

Ezt a beállítást konfigurálhatja csak erre a szabályra, az összes szabályra, vagy az ebben a kategóriában (elnevezés) szereplő összes szabályra, amelyekre vonatkozik. További információ: Kódminőségi szabály konfigurációs beállításai.

Adott API-felületek belefoglalása

A kódbázis azon részeit konfigurálhatja, amelyeken futtathatja ezt a szabályt az akadálymentességük alapján. Ha például meg szeretné adni, hogy a szabály csak a nem nyilvános API-felületen fusson, adja hozzá a következő kulcs-érték párot a projekt egyik .editorconfig fájljához:

dotnet_code_quality.CAXXXX.api_surface = private, internal

Példa a szabálysértésre

Az alábbi példa a szabály megsértését mutatja be.

public class Class1
{
    protected string someName;
    public string SomeName => someName;
}

Az alábbi példa a szabálysértés kijavításának egyik módját mutatja be

public class Class1
{
    protected string _someName;
    public string SomeName => _someName;
}