CA1848: A LoggerMessage-meghatalmazottak használata
Tulajdonság | Érték |
---|---|
Szabályazonosító | CA1848 |
Cím | A LoggerMessage-meghatalmazottak használata |
Kategória | Teljesítmény |
A javítás kompatibilitástörő vagy nem törik | Nem törés |
Alapértelmezés szerint engedélyezve a .NET 8-ban | Nem |
Ok
A naplózóbővítmény metódusainak használata, például LogInformation ésLogDebug.
Szabály leírása
Nagy teljesítményű naplózási forgatókönyvekhez használja a LoggerMessage mintát.
Szabálysértések kijavítása
A szabály megsértéseinek kijavítására használható LoggerMessage
.
LoggerMessage a Logger bővítménymetelyekkel szemben a következő teljesítményelőnyöket biztosítja:
- A naplózási bővítmény metódusaihoz "boxing" (konvertálás) típusú értéktípusokra van szükség, például
int
:object
. A LoggerMessage minta elkerüli a ökölvívást azáltal, hogy statikus Action mezőket és bővítménymetszeteket használ erősen gépelt paraméterekkel. - A naplózó bővítmény metódusainak minden alkalommal elemezniük kell az üzenetsablont (elnevezett formátumsztringet), amikor naplóüzenetet írnak. LoggerMessage csak egyszer kell elemezni egy sablont az üzenet definiálásakor.
Mikor kell letiltani a figyelmeztetéseket?
Ne tiltsa el a szabály figyelmeztetését.
Kapcsolódó információk
Dolgozzon együtt velünk a GitHubon
A tartalom forrása a GitHubon található, ahol létrehozhat és áttekinthet problémákat és lekéréses kérelmeket is. További információért tekintse meg a közreműködői útmutatónkat.