Los mensajes de registro pueden enviarse desde el programa a través de un punto de registro ya registrado. Para enviar un mensaje de registro, es necesario invocar el método AddLogEntry del punto de registro.
El método AddLogEntry requiere las siguientes entradas:
oi_sMessage: El mensaje de registro como texto libre. Los números o las enumeraciones tienen que convertirse en una STRING para poder enviarlos como parte del mensaje.
oi_etLogLevel: Cada mensaje debe asignarse con un ET_LogLevel en función de la importancia del mensaje.
oi_etDiag, i_udiDiagExt: Cada mensaje obtiene los datos de diagnóstico para admitir un mejor filtrado.
Cada punto de registro puede asignarse a un nivel de registro que represente la prioridad de los mensajes. El punto de registro envía el mensaje al registro de aplicaciones. Si el nivel de registro asignado al método AddLogEntry tiene una prioridad inferior al nivel de registro del punto de registro, se ignorará el mensaje, que no se añadirá al registro del registro de aplicaciones.
Debido a este mecanismo de filtro, los mensajes de depuración pueden tratarse de la misma manera que los mensajes de diagnóstico de prioridad alta sin tener que generar por ello demasiados mensajes.
No obstante, hay que tener en cuenta las dos reglas siguientes al enviar mensajes de registro:
1. Con cada llamada del método AddLogEntry, se añade un nuevo mensaje al registro de aplicaciones. Si no desea crear una nueva entrada de registro, asegúrese de no invocar este método de manera cíclica en el proyecto o bien muchas veces en un mismo ciclo.
2. La llamada del método AddLogEntry no necesita demasiados recursos de la CPU. Tenga en cuenta, sin embargo, que la creación del mensaje de registro con operaciones de más cadenas como, por ejemplo, CONCAT o INSERT, sí puede necesitar muchos más recursos de la CPU. Si se utilizan varias operaciones de cadenas para crear el mensaje, compruebe si el mensaje se envía al registro de aplicaciones. Si el nivel de registro del mensaje tiene una prioridad inferior al nivel de registro del punto de registro, no será necesario crear el mensaje.
