Udostępnij przez

Pliki dziennika (poS dla zestawu SDK platformy .NET w wersji 1.14)

Program Microsoft Point of Service dla platformy .NET (POS dla platformy .NET) zawiera funkcję rejestrowania na potrzeby rejestrowania punktów zakupu dla platformy .NET, obiektów usługi i zdarzeń aplikacji. Parametry rejestrowania są odczytywane z poS dla klucza rejestru .NET, \HKLM\SOFTWARE\POSfor.NET\Logging, a wpisy są zapisywane przy użyciu Logger klasy .

Włączanie rejestrowania

Rejestrowanie jest włączone, gdy klucz rejestru \HKLM\SOFTWARE\POSfor.NET\Logging\Enabled jest ustawiony na dowolną wartość inną niż zero.

Rozmiar pliku dziennika

Maksymalny rozmiar pliku dziennika jest określony w kluczu rejestru \HKLM\SOFTWARE\POSfor.NET\Logging\MaxLogFileSizeMB. Jeśli ten rozmiar pliku zostanie przekroczony podczas rejestrowania jest włączony, rejestrowanie zostanie zatrzymane. Nie zostanie zwrócony wyjątek ani błąd do aplikacji.

Domyślnie maksymalny rozmiar pliku dziennika to 10 megabajtów (MB).

Lokalizacja pliku dziennika

Klucz rejestru \HKLM\SOFTWARE\POSfor.NET\Logging\location służy do określania, gdzie będą zapisywane pliki dziennika.

Domyślnie ta lokalizacja jest ustawiona na zmienną środowiskową %TEMP%, która w systemie Windows domyślnie jest ustawiona na katalog C:\Documents i Ustawienia\(nazwa_użytkownika)\Local Ustawienia\temp. Jest to katalog dla poszczególnych użytkowników.

Nazwy plików dziennika

Nazwy plików dziennika składają się z trzech elementów:

  • Nazwa pliku podstawowego zawarta w kluczu rejestru \HKLM\SOFTWARE\POSfor.NET\Logging\Name. Wartość domyślna dla tej wartości to PosFor.Net.
  • Sygnatura czasowa w tym formacie: (rrrr-mm-dd hh-mm-ssZ)
  • .txt rozszerzenia pliku.

Jest to przykład typowej nazwy pliku dziennika:

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

Nagłówek pliku dziennika

Nagłówek zawierający informacje, takie jak użytkownik, system operacyjny, wywołujący wątek i proces, jest zapisywany w każdym pliku dziennika podczas jego tworzenia. Ten nagłówek zawiera następujące pola:

  • Bieżący użytkownik: nazwa bieżącego użytkownika.
  • Nazwa komputera: nazwa komputera tworzącego dziennik.
  • Wersja systemu operacyjnego: wersja systemu Windows, która jest uruchamiana, w tym dodatki Service Pack.
  • Środowisko uruchomieniowe platformy .Net: wersja środowiska uruchomieniowego platformy .NET.
  • Identyfikator procesu: identyfikator PID procesu, który utworzył plik dziennika.
  • Identyfikator wątku: wątek, który utworzył dziennik.
  • Maksymalny rozmiar pliku dziennika: maksymalny rozmiar pliku do użycia dla tego pliku dziennika.
  • Plik: nazwa pliku wykonywalnego, który utworzył plik dziennika.
  • InternalName: wewnętrzna nazwa pliku wykonywalnego.
  • OriginalFilename: oryginalna nazwa pliku wykonywalnego.
  • FileVersion: informacje o wersji przechowywane w pliku wykonywalnych.
  • FileDescription: opis przechowywany w pliku wykonywalnego.
  • Produkt: opis produktu przechowywany w pliku wykonywalny.
  • ProductVersion: wersja pliku przechowywana w pliku wykonywalnego.
  • Debugowanie: flaga debugowania.
  • Poprawiono: poprawiony plik.
  • Wersja wstępna: flaga wersji wstępnej.
  • PrivateBuild: flaga kompilacji prywatnej.
  • SpecialBuild: specjalna flaga kompilacji.
  • Język: język używany do tworzenia pliku dziennika.

Wpisy pliku dziennika

Wpisy dziennika mogą być tworzone przez usługę POS dla platformy .NET lub przez aplikację lub obiekt usługi. Wpisy są tworzone przez wywołanie odpowiedniej metody w wystąpieniu klasy Rejestrator .

Każdy wpis zawiera następujące pola:

  • Znacznik czasu.

  • Identyfikator wątku, który utworzył wpis.

  • Poziom ważności. Każdy wpis dziennika jest oznaczony jego poziomem ważności, który jest określany przez metodę rejestratora .

    Tag ważności w wpisach dziennika Odpowiadająca metoda rejestratora
    INFO Logger.Info
    OSTRZEŻENIE Logger.Warning
    BŁĄD Logger.Error

  • Ciąg nazwy określony przez kod, który nazwał metodę Rejestratora . Ten ciąg jest określony, gdy wywoływana jest metoda rejestratora i nie musi zawierać nazwy pliku wykonywalnego.

  • Na przykład typowy wpis w pliku dziennika wygląda następująco: [8/10/2006 6:12:14 PM 2936 INFO PosExplorer] Wprowadzanie loadExplorer()

Komentarze

Jeśli plik dziennika jest otwarty, a aplikacja wywołuje Refresh() metodę, plik zostanie zamknięty i nowy utworzony za pomocą zaktualizowanego sygnatury czasowej.

Zobacz też

Odwołanie

Pojęcia

Inne zasoby

  • Last updated on