Delen via

Logboekbestanden (POS voor .NET v1.14 SDK-documentatie)

Microsoft Point of Service voor .NET (POS voor .NET) bevat een functie voor logboekregistratie voor het opnemen van POS voor .NET, serviceobjecten en toepassingsevenementen. Logboekregistratieparameters worden gelezen uit de registersleutel POS for .NET, \HKLM\SOFTWARE\POSfor.NET\Logging en vermeldingen worden geschreven met behulp van de Logger klasse.

Logboekregistratie inschakelen

Logboekregistratie is ingeschakeld wanneer de registersleutel \HKLM\SOFTWARE\POSfor.NET\Logging\Enabled is ingesteld op een waarde die niet nul is.

Grootte van logboekbestand

De maximale grootte van het logboekbestand is opgegeven in de registersleutel \HKLM\SOFTWARE\POSfor.NET\Logging\MaxLogFileSizeMB. Als deze bestandsgrootte wordt overschreden terwijl logboekregistratie is ingeschakeld, wordt logboekregistratie gestopt. Er wordt geen uitzondering of fout geretourneerd naar de toepassing.

De maximale grootte van het logboekbestand is standaard 10 MB (megabyte).

Locatie logbestand

De registersleutel \HKLM\SOFTWARE\POSfor.NET\Logging\location wordt gebruikt om te bepalen waar logboekbestanden worden geschreven.

Deze locatie is standaard ingesteld op de omgevingsvariabele %TEMP%. In Windows wordt standaard de map C:\Documents and Instellingen\(username)\Local Instellingen\temp gebruikt. Dit is een map per gebruiker.

Namen van logboekbestanden

Namen van logboekbestanden bestaan uit drie elementen:

  • De basisbestandsnaam in de registersleutel \HKLM\SOFTWARE\POSfor.NET\Logging\Name. De standaardwaarde voor deze waarde is PosFor.Net.
  • Een tijdstempel in deze notatie: (jjjj-mm-dd hh-mm-ssZ)
  • De bestandsextensie .txt.

Dit is een voorbeeld van een typische logboekbestandsnaam:

PosFor.Net(2006-08-10 18-33-29Z).txt

Koptekst van logboekbestand

Een header met informatie zoals de gebruiker, het besturingssysteem, de aanroepende thread en het proces wordt naar elk logboekbestand geschreven wanneer het wordt gemaakt. Deze header bevat de volgende velden:

  • Huidige gebruiker: de naam van de huidige gebruiker.
  • Computernaam: de naam van de computer die het logboek maakt.
  • Versie van het besturingssysteem: de versie van Windows die wordt uitgevoerd, inclusief servicepacks.
  • .Net-runtime: de versie van de .NET-runtime.
  • Proces-id: de PID van het proces dat het logboekbestand heeft gemaakt.
  • Thread-id: de thread die het logboek heeft gemaakt.
  • Maximale grootte van logboekbestanden: de maximale bestandsgrootte die moet worden gebruikt voor dit logboekbestand.
  • Bestand: de naam van het uitvoerbare bestand dat het logboekbestand heeft gemaakt.
  • InternalName: de interne naam van het uitvoerbare bestand.
  • OriginalFilename: de oorspronkelijke naam van het uitvoerbare bestand.
  • FileVersion: de versie-informatie die is opgeslagen in het uitvoerbare bestand.
  • FileDescription: de beschrijving die is opgeslagen in het uitvoerbare bestand.
  • Product: De productbeschrijving die is opgeslagen in het uitvoerbare bestand.
  • ProductVersion: de bestandsversie die is opgeslagen in het uitvoerbare bestand.
  • Fouten opsporen: vlag voor foutopsporing.
  • Patched: Patched-bestand.
  • PreRelease: vlag vóór release.
  • PrivateBuild: private build flag.
  • SpecialBuild: Speciale buildvlag.
  • Taal: de taal die wordt gebruikt om het logboekbestand te maken.

Vermeldingen van logboekbestanden

Logboekvermeldingen kunnen worden gemaakt door POS voor .NET of door de toepassing of het serviceobject. Vermeldingen worden gemaakt door de juiste methode aan te roepen op een exemplaar van de loggerklasse .

Elk item bevat de volgende velden:

  • Timestamp.

  • Thread-id waarmee de vermelding is gemaakt.

  • Urgentieniveau. Elke logboekvermelding wordt gemarkeerd met het urgentieniveau dat wordt bepaald door welke loggermethode wordt gebruikt.

    Urgentielabel in logboekvermeldingen Bijbehorende loggermethode
    INFO Logger.Info
    WARNING Logger.Warning
    FOUT Logger.Error

  • Naamtekenreeks die is opgegeven door de code die de loggermethode wordt genoemd. Deze tekenreeks wordt opgegeven wanneer de loggermethode wordt aangeroepen en mogelijk niet noodzakelijkerwijs de naam van het uitvoerbare bestand bevat.

  • Een typische vermelding in het logboekbestand ziet er bijvoorbeeld als volgt uit: [10-8-2006 6:12:14 PM 2936 INFO PosExplorer] LoadExplorer() invoeren

Opmerkingen

Als er een logboekbestand is geopend en de toepassing de Refresh() methode aanroept, wordt het bestand gesloten en een nieuw bestand gemaakt met het bijgewerkte tijdstempel.

Zie ook

Verwijzing

Concepten

Meer informatie

  • Last updated on