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

CA1848: A LoggerMessage-meghatalmazottak használata

  • Cikk
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