Programovanie

Ako pracovať s log4net v C #

Pri práci na aplikáciách môžete často chcieť zaznamenať údaje, ktoré môžu obsahovať, postupnosť udalostí vo vašej aplikácii, akcie používateľov alebo dokonca chyby, keď sa vyskytnú. Existuje veľa rámcov na protokolovanie, ktoré môžete použiť, ale log4net je zďaleka jedným z najpopulárnejších rámcov na protokolovanie pre použitie s aplikáciami vytvorenými alebo vyvinutými v .NET. Jedná sa o knižnicu typu open source (port populárnej knižnice open source log4j pre Java), ktorú je možné použiť na zaznamenávanie údajov aplikácií do rôznych cieľov protokolu v .NET.

Inštaluje sa log4net

Najjednoduchší a najrýchlejší spôsob, ako začať používať protokol log4net, je jeho inštalácia prostredníctvom správcu balíkov NuGet. Za predpokladu, že ste vytvorili projekt konzolovej aplikácie v Visual Studio, môžete nainštalovať log4net cez NuGet Manager podľa týchto krokov.

  1. V okne Prieskumník riešení vyberte a kliknite pravým tlačidlom myši na svoj projekt
  2. Kliknite na možnosť „Spravovať balíčky NuGet ...“
  3. Kliknite na „Online“ a do vyhľadávacieho poľa zadajte log4net
  4. Vyberte balíček log4net, ktorý chcete nainštalovať
  5. Kliknutím na tlačidlo „Inštalovať“ spustíte proces inštalácie

V čase písania tohto článku je najnovšie stabilné vydanie protokolu log4net 2.0.5. Po nainštalovaní protokolu log4net prostredníctvom správcu balíkov NuGet by ste pozorovali pridanie súboru log4net ako odkazu na váš projekt.

Konfigurácia protokolu log4net

Teraz, keď bol balík log4net úspešne nainštalovaný, pridajte nasledujúci riadok do súboru AssemblyInfo.cs v priečinku Vlastnosti vášho projektu. Ak to nie je zadané, konfiguračné nastavenia by sa nebrali do úvahy.

[assembly: log4net.Config.XmlConfigurator (ConfigFile = "Log4Net.config", Watch = true)]

Prípadne to isté môžete spomenúť v súbore app.config alebo web.config.

[assembly: log4net.Config.XmlConfigurator (Watch = true)]

Ak sa vaše metaúdaje konfigurácie log4net nachádzajú v nejakom inom súbore (t. J. Inom ako súbory web.config alebo app.config), môžete namiesto toho určiť nasledujúce.

[assembly: log4net.Config.XmlConfigurator (ConfigFile = "log4net.config", Watch = true)]

Ďalším krokom je zadanie potrebných podrobností konfigurácie pre log4net v súbore app.config alebo web.config vo vašej aplikácii. Za predpokladu, že používate projekt konzolovej aplikácie, pridajte do súboru app.config konfiguračnú časť s názvom „log4net“, ako je uvedené nižšie.

Teraz pridajte za prvok v súbore app.config sekciu „“. Ďalej v časti „“ umiestnite podrobnosti konfigurácie, ako je uvedené v útržku kódu uvedenom nižšie.

To je všetko, čo musíte urobiť, aby ste nakonfigurovali log4net. Teraz sa pozrime, ako to môžeme použiť v našom kóde. Element sa používa na zadanie názvu a typu použitého záznamníka. V tomto príklade používame doplnok posuvného súboru. Existuje však veľa ďalších typov prídavných zariadení, napríklad AdoNetAppender, AspNetTraceAppender, ConsoleAppender atď. Tu je úplný zoznam a postup konfigurácie ďalších prídavných zariadení.

Pomocou protokolu log4net

Vo svojej triede vytvorte odkaz na ILog uskutočnením hovoru na statickú metódu GetLogger triedy LogManager, ako je uvedené v útržku kódu uvedenom nižšie.

súkromný statický iba na čítanie log4net.ILog log =

log4net.LogManager.GetLogger

(System.Reflection.MethodBase.GetCurrentMethod (). DeclaringType);

Teraz môžete použiť inštanciu s názvom log na protokolovanie údajov do nakonfigurovaných cieľov. Nasledujúci úryvok kódu ilustruje, ako môžete teraz využiť inštanciu protokolu na zaznamenávanie údajov.

log.Debug ("Toto je správa Debug");

log.Info ("Toto je informačná správa");

log.Warn ("Toto je varovná správa");

log.Error ("Toto je chybové hlásenie");

log.Fatal ("Toto je fatálna správa");

Tu je kompletný zoznam kódov, ktorý ukazuje, ako môžete prihlásiť svoju správu o výnimke do textového súboru pomocou protokolu log4net.

triedny program

   {

statický iba na čítanie log4net.ILog log =

log4net.LogManager.GetLogger

(System.Reflection.MethodBase.GetCurrentMethod (). DeclaringType);

static void Main (reťazec [] args)

       {

skús

           {

vyvolať novú výnimku („Toto je testovacia správa ...“);

           }

úlovok (výnimka okrem)

           {

log.Error (ex.Message);

           }          

Console.Read ();

       }

   }

Po vykonaní vyššie uvedeného programu sa vytvorí textový súbor s názvom .log a spolu s časovou značkou sa zaznamená aj správa o výnimke zadaná v. Pamätajte, že log4net môžete použiť aj programovo, t. J. Konfigurácia programu log4net tak, aby bolo potrebné konfigurovať, o čom sme hovorili vyššie.

$config[zx-auto] not found$config[zx-overlay] not found