Invio dei messaggi di registro

Generale

È possibile inviare messaggi di registro dal programma tramite un'origine registro già registrata. Per inviare un messaggio di registro, occorre chiamare il metodo AddLogEntry dell'origine registro.

Il metodo AddLogEntry richiede i seguenti ingressi:

oi_sMessage: il messaggio di registro come testo libero. Numeri o enumerazioni devono essere convertiti in STRING prima di poterli inviare come parte del messaggio.

oi_etLogLevel: ogni messaggio deve essere assegnato con un ET_LogLevel in base all'importanza del messaggio.

oi_etDiag, i_udiDiagExt: ogni messaggio ricava i dati di diagnostica per supportare un filtraggio migliore.

Ogni origine registro può essere assegnata a un livello di registro che rappresenta la priorità dei messaggi. L'origine registro invia il messaggio al registro applicazioni. Se il livello di registro fornito al metodo AddLogEntry ha una priorità più bassa dell'origine registro, il messaggio viene ignorato e non aggiunto alla registrazione del registro applicazioni.

A causa di questo meccanismo di filtro, è possibile gestire i messaggi di debug allo stesso modo dei messaggi di diagnostica ad alta priorità senza produrre un numero eccessivo di messaggi.

Tenere tuttavia presente le due regole seguenti quando si inviano messaggi di registro:

1. Ogni chiamata del metodo AddLogEntry aggiunge un nuovo messaggio al registro applicazioni. Se non si desidera creare una nuova voce di registrazione, verificare di non chiamare questo metodo ciclicamente nel progetto o troppe volte in un singolo ciclo.

2. La chiamata del metodo AddLogEntry non richiede eccessiva potenza della CPU. Ricordare, tuttavia, che la creazione del messaggio di registro con più operazioni stringa come CONCAT, INSERT e così via può richiedere molta potenza della CPU. Se si utilizzano molte operazioni stringa per creare il messaggio, verificare che il messaggio venga inviato al registro applicazioni. Se il livello di registro del messaggio ha una priorità più bassa del livello dell'origine registro, non occorre creare il messaggio.