EventLog.WriteEntry, méthode (String, EventLogEntryType) [C#]
Écrit une entrée d'erreur, d'avertissement, d'information, d'audit des succès ou des échecs avec le texte de message donné, dans le journal des événements.
Utilisez cette méthode pour écrire une entrée d'un
EventLogEntryType spécifié dans le journal des événements. type est indiqué dans
l'Observateur d'événements d'un journal par une icône et un texte dans la colonne Type.
Vous devez définir la propriété Source sur votre composant
EventLog avant d'écrire des entrées dans le journal. Vous pouvez appeler CreateEventSource sur une source nouvelle pour l'inscrire avant d'écrire dans le journal des événements, mais ce n'est pas nécessaire. Si la source spécifiée dans la propriété Source de cette instance de
EventLog n'est pas inscrite dans l'ordinateur où votre composant écrit,
WriteEntry appelle
CreateEventSource et inscrit la source.
Remarque Si vous ne spécifiez pas
MachineName pour votre instance
EventLog avant d'appeler
CreateEventSource ou
WriteEntry, l'ordinateur local (".") est pris implicitement.
Si le système a besoin d'inscrire
Source par l'intermédiaire d'un appel à
WriteEntry et si la propriété Log n'a pas été définie sur votre instance de
EventLog, elle prend la valeur du journal Applications par défaut.
Remarque Beaucoup d'exceptions signalées ci-dessus sont générées par des erreurs déclenchées au cours de la procédure d'inscription de Source.
WriteEntry vous permet de spécifier un message de chaîne à écrire dans le journal. Cette méthode écrit la chaîne donnée directement dans le journal ; elle n'utilise pas un fichier de message localisable.
Remarque Si vous écrivez une entrée sur un ordinateur distant, la valeur du message (la chaîne de texte) peut ne pas être ce que vous attendez si le .NET Framework ne fonctionne pas sur l'ordinateur distant.
Exemple
L'exemple ci-dessous écrit une entrée d'avertissement dans un journal des événements, "MyNewLog", sur l'ordinateur local.
Remarque WriteEntry crée la source "MySource" si elle n'existe pas.
[C#]
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
| using System;
using System.Diagnostics;
using System.Threading;
class MySample{
public static void Main(){
// Create an EventLog instance and assign its source.
EventLog myLog = new EventLog();
myLog.Source = "MySource";
// Write an informational entry to the event log.
myLog.WriteEntry("Writing warning to event log.", EventLogEntryType.Warning);
}
} |
Partager