Strādājot ar lietojumprogrammām, jūs bieži vēlaties reģistrēt lietojumprogrammas datus, kas var ietvert notikumu secību jūsu lietojumprogrammā, lietotāja darbības vai pat kļūdas, kad tās notiek. Ir daudz reģistrēšanas sistēmu, kuras varat izmantot, taču log4net līdz šim ir viens no populārākajiem mežizstrādes ietvariem, kas paredzēts lietošanai ar lietojumprogrammām, kas izveidotas vai attīstītas .NET. Tā ir atvērtā pirmkoda bibliotēka (populāras Java atvērtā pirmkoda bibliotēkas osta), kuru var izmantot, lai reģistrētu lietojumprogrammas datus dažādiem žurnāla mērķiem .NET.
Notiek log4net instalēšana
Vienkāršākais un ātrākais veids, kā sākt lietot log4net, ir instalēt to, izmantojot NuGet pakešu pārvaldnieku. Pieņemot, ka Visual Studio esat izveidojis konsoles lietojumprogrammas projektu, varat instalēt log4net, izmantojot NuGet Manager, veicot šīs darbības.
- "Solution Explorer logā" atlasiet un ar peles labo pogu noklikšķiniet uz sava projekta
- Noklikšķiniet uz Pārvaldīt NuGet paketes ...
- Noklikšķiniet uz "Tiešsaiste" un pēc tam meklēšanas lodziņā ierakstiet log4net
- Atlasiet pakotni log4net, kuru vēlaties instalēt
- Noklikšķiniet uz "Instalēt", lai sāktu instalēšanas procesu
Šajā rakstā jaunākais stabilais log4net izlaidums ir 2.0.5. Kad log4net ir instalēts, izmantojot NuGet Package Manager, jūs ievērosiet pievienoto log4net montāžu kā atsauci uz jūsu projektu.
Konfigurē log4net
Tagad, kad pakete log4net ir veiksmīgi instalēta, pievienojiet šo rindu failam AssemblyInfo.cs, kas atrodas projekta mapē Rekvizīti. Ja tas nav norādīts, konfigurācijas iestatījumi netiks ņemti vērā.
[montāža: log4net.Config.XmlConfigurator (ConfigFile = "Log4Net.config", Watch = true)]
Alternatīvi to pašu varat pieminēt arī failā app.config vai web.config.
[montāža: log4net.Config.XmlConfigurator (Skatīties = patiess)]
Ja jūsu log4net konfigurācijas metadati atrodas kādā citā failā (t.i., izņemot failus web.config vai app.config), tā vietā varat norādīt tālāk norādīto.
[montāža: log4net.Config.XmlConfigurator (ConfigFile = "log4net.config", Watch = true)]
Nākamais solis ir norādīt nepieciešamo log4net konfigurācijas informāciju lietotnē app.config vai failā web.config. Pieņemot, ka izmantojat konsoles lietojumprogrammas projektu, failā app.config pievienojiet konfigurācijas sadaļu ar nosaukumu "log4net", kā parādīts zemāk.
Tagad pievienojiet sadaļu "" pēc elementa failā app.config. Pēc tam sadaļā "" ievietojiet informāciju par konfigurāciju, kā parādīts tālāk sniegtajā koda fragmentā.
Tas ir viss, kas jums jādara, lai konfigurētu log4net. Tagad izpētīsim, kā mēs to varam izmantot savā kodā. Elementu izmanto, lai norādītu izmantojamā reģistrētāja nosaukumu un veidu. Šajā piemērā mēs izmantojam ritošā faila piedevu. Tomēr ir pieejami daudzi citi papildinājumu veidi, t.i., AdoNetAppender, AspNetTraceAppender, ConsoleAppender utt. Šeit ir pilns saraksts un kā konfigurēt citus papildinātājus.
Izmantojot log4net
Savā klasē izveidojiet atsauci uz ILog, izsaucot LogManager klases statisko metodi GetLogger, kā parādīts tālāk sniegtajā koda fragmentā.
privāts statisks tikai lasāms log4net.ILog log =log4net.LogManager.GetLogger
(System.Reflection.MethodBase.GetCurrentMethod (). DeclaringType);
Tagad reģistrēto datu reģistrēšanai konfigurētajos mērķos varat izmantot eksemplāru ar nosaukumu žurnāls. Šis koda fragments parāda, kā tagad varat izmantot žurnāla instances priekšrocības, lai reģistrētu datus.
log.Debug ("Šis ir atkļūdošanas ziņojums");log.Info ("Šī ir Info ziņa");
log.Warn ("Šis ir brīdinājuma ziņojums");
log.Error ("Šis ir kļūdas ziņojums");
log.Fatal ("Šis ir fatāls ziņojums");
Šeit ir pilns kodu saraksts, kas parāda, kā jūs varat reģistrēt izņēmuma ziņojumu teksta failā, izmantojot log4net.
klases programma{
statisks tikai lasāms log4net.ILog žurnāls =
log4net.LogManager.GetLogger
(System.Reflection.MethodBase.GetCurrentMethod (). DeclaringType);
static void Main (virkne [] args)
{
mēģiniet
{
mest jaunu izņēmumu ("Šis ir testa ziņojums ...");
}
nozveja (izņēmums ex)
{
log.Error (ex.Message);
}
Konsole. Lasīt ();
}
}
Pēc iepriekš minētās programmas izpildes tiks izveidots teksta fails ar nosaukumu .log un ar norādīto izņēmuma ziņojumu tiks reģistrēts kopā ar laika zīmogu. Ņemiet vērā, ka log4net varat izmantot arī programmatiski, t.i., konfigurēt log4net programmatiski izsaka nepieciešamību pēc iepriekš apspriestās konfigurācijas.
