CA1725: A paraméterek nevének meg kell egyeznie az alapdeklarációval
Tulajdonság | Érték |
---|---|
Szabályazonosító | CA1725 |
Cím | A paraméterneveknek meg kell egyeznie az alapdeklarációval |
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
A metódus felülbírálásában szereplő paraméter neve nem egyezik meg a metódus alapdeklarációjában szereplő paraméter nevével vagy a paraméter nevével a metódus felületi deklarációjában.
Ez a szabály alapértelmezés szerint csak külsőleg látható metódusokat tekint meg, de ez konfigurálható.
Szabály leírása
A paraméterek egységes elnevezése a felülbírálási hierarchiában növeli a metódus felülbírálásainak használhatóságát. A származtatott metódus azon paraméterneve, amely eltér az alapdeklarációban szereplő névtől, zavart okozhat abban, hogy a metódus az alapmetódus felülbírálása vagy a metódus új túlterhelése.
Szabálysértések kijavítása
A szabály megsértésének kijavításához nevezze át a paramétert az alapdeklarációnak megfelelően. A javítás a com-beli látható metódusok kompatibilitástörő változása.
Mikor kell letiltani a figyelmeztetéseket?
Ne tiltsa le a szabály figyelmeztetését, kivéve a korábban kiszállított kódtárak com-beli látható metódusait.
Figyelmeztetés mellőzése
Ha csak egyetlen szabálysértést szeretne letiltani, adjon hozzá előfeldolgozási irányelveket a forrásfájlhoz a szabály letiltásához és újbóli engedélyezéséhez.
#pragma warning disable CA1725
// The code that's violating the rule is on this line.
#pragma warning restore CA1725
Ha le szeretné tiltani egy fájl, mappa vagy projekt szabályát, állítsa annak súlyosságát none
a konfigurációs fájlban.
[*.{cs,vb}]
dotnet_diagnostic.CA1725.severity = none
További információ: Kódelemzési figyelmeztetések letiltása.
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
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: