Compartir a través de

Archivos de registro (documentación del SDK de POS para .NET v1.14)

Microsoft Point of Service para .NET (POS para .NET) incluye una característica de registro para grabar los eventos de POS para .NET, los objetos de servicio y la aplicación. Los parámetros de registro se leen de la clave del Registro de POS para .NET, \HKLM\SOFTWARE\POSfor.NET\Logging y las entradas se escriben mediante la clase Logger.

Habilitar el registro

El registro está habilitado cuando la clave del Registro \HKLM\SOFTWARE\POSfor.NET\Logging\Enabled se establece en cualquier valor distinto de cero.

Tamaño del archivo de registro

El tamaño máximo del archivo de registro se especifica en la clave del Registro \HKLM\SOFTWARE\POSfor.NET\Logging\MaxLogFileSizeMB. Si se supera este tamaño de archivo mientras el registro está habilitado, el registro se detendrá. No se devolverá ninguna excepción ni error a la aplicación.

De manera predeterminada, el tamaño máximo del archivo de registro es de 10 megabytes (MB).

Ubicación del archivo de registro

La clave del Registro \HKLM\SOFTWARE\POSfor.NET\Logging\location se usa para determinar dónde se escribirán los archivos de registro.

De manera predeterminada, esta ubicación se establece en la variable de entorno %TEMP% que, en Windows, tiene como valor predeterminado el directorio C:\Documents and Settings\(username)\Local Settings\temp. Se trata de un directorio por cada usuario.

Nombres de archivo de registro

Los nombres de archivo de registro se componen de tres elementos:

  • Nombre de archivo base, contenido en la clave del Registro \HKLM\SOFTWARE\POSfor.NET\Logging\Name. El valor predeterminado de este valor es PosFor.Net.
  • Marca de tiempo con este formato: (aaaa-mm-dd hh-mm-ssZ)
  • La extensión de archivo .txt.

Este es un ejemplo de un nombre de archivo de registro típico:

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

Encabezado del archivo de registro

Cuando se crea, se escribe en cada archivo de registro un encabezado que contiene información como el usuario, el sistema operativo, el subproceso autor de la llamada y el proceso. Este encabezado incluye los siguientes campos:

  • Current user: nombre del usuario actual.
  • Computer name: nombre del equipo que crea el registro.
  • OS version: versión de Windows que se está ejecutando, incluidos los Service Packs.
  • .Net runtime: versión del entorno de ejecución de .NET.
  • Process Id: PID del proceso que creó el archivo de registro.
  • Thread Id: subproceso que creó el registro.
  • Max log file size: tamaño máximo del archivo que se va a usar para este archivo de registro.
  • File: nombre del archivo ejecutable que creó el archivo de registro.
  • InternalName: nombre interno del archivo ejecutable.
  • OriginalFilename: nombre original del archivo ejecutable.
  • FileVersion: información de versión almacenada en el archivo ejecutable.
  • FileDescription: descripción almacenada en el archivo ejecutable.
  • Product: descripción del producto almacenada en el archivo ejecutable.
  • Productversion: versión del archivo almacenada en el archivo ejecutable.
  • Debug: marca de depuración.
  • Patched: archivo revisado.
  • PreRelease: marca de versión preliminar.
  • PrivateBuild: marca de compilación privada.
  • SpecialBuild: marca de compilación especial.
  • Language: lenguaje usado para crear el archivo de registro.

Entradas del archivo de registro

Las entradas del registro se pueden crear mediante POS para .NET o mediante la aplicación o el objeto de servicio. Las entradas se crean llamando al método adecuado en una instancia de la clase Logger.

Cada entrada contiene los siguientes campos:

  • Timestamp.

  • Identificador del subproceso que creó la entrada.

  • Nivel de importancia. Cada entrada del registro se marca con su nivel de importancia, que viene determinado por el método Logger implicado.

    Etiqueta de importancia en las entradas del registro Método del registrador correspondiente
    INFO Logger.Info
    WARNING Logger.Warning
    ERROR Logger.Error

  • Cadena de nombre especificada por el código que llamó al método Logger. Esta cadena se especifica cuando se invoca al método Logger y puede que no contenga necesariamente el nombre del archivo ejecutable.

  • Por ejemplo, una entrada típica en el archivo de registro tendría este aspecto: [8/10/2006 6:12:14 PM 2936 INFO PosExplorer] Entering LoadExplorer()

Comentarios

Si hay un archivo de registro abierto y la aplicación llama al método Refresh(), se cierra el archivo y se crea uno nuevo con la marca de tiempo actualizada.

Consulte también

Referencia

Conceptos

Otros recursos

  • Last updated on