EventLog.WriteEntry Méthode

Définition

Espace de noms:: System.Diagnostics

Assembly:: System.Diagnostics.EventLog.dll

Assembly:: System.dll

Paquet:: System.Diagnostics.EventLog v11.0.0-preview.2.26159.112

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Écrit une entrée dans le journal des événements.

Surcharges

Nom	Description
WriteEntry(String, String, EventLogEntryType, Int32, Int16, Byte[])	Écrit une entrée avec le texte du message, l’identificateur d’événement défini par l’application et la catégorie définie par l’application dans le journal des événements (à l’aide de la source d’événement inscrite spécifiée) et ajoute des données binaires au message.
WriteEntry(String, String, EventLogEntryType, Int32, Int16)	Écrit une entrée avec le texte du message, l’identificateur d’événement défini par l’application et la catégorie définie par l’application dans le journal des événements, à l’aide de la source d’événement inscrite spécifiée. Vous `category` pouvez l’utiliser par l’Observateur d’événements pour filtrer les événements dans le journal.
WriteEntry(String, EventLogEntryType, Int32, Int16, Byte[])	Écrit une entrée avec le texte du message donné, l’identificateur d’événement défini par l’application et la catégorie définie par l’application dans le journal des événements et ajoute des données binaires au message.
WriteEntry(String, String, EventLogEntryType, Int32)	Écrit une entrée avec le texte du message donné et l’identificateur d’événement défini par l’application dans le journal des événements, à l’aide de la source d’événement inscrite spécifiée.
WriteEntry(String, EventLogEntryType, Int32, Int16)	Écrit une entrée avec le texte du message donné, l’identificateur d’événement défini par l’application et la catégorie définie par l’application dans le journal des événements.
WriteEntry(String, EventLogEntryType)	Écrit une erreur, un avertissement, des informations, un audit de réussite ou une entrée d’audit d’échec avec le texte du message donné dans le journal des événements.
WriteEntry(String, EventLogEntryType, Int32)	Écrit une entrée avec le texte du message donné et l’identificateur d’événement défini par l’application dans le journal des événements.
WriteEntry(String, String)	Écrit une entrée de type d’informations avec le texte du message donné dans le journal des événements, à l’aide de la source d’événement inscrite spécifiée.
WriteEntry(String)	Écrit une entrée de type d’informations, avec le texte du message donné, dans le journal des événements.
WriteEntry(String, String, EventLogEntryType)	Écrit une erreur, un avertissement, des informations, un audit de réussite ou une entrée d’audit d’échec avec le texte du message donné dans le journal des événements, à l’aide de la source d’événement inscrite spécifiée.

WriteEntry(String, String, EventLogEntryType, Int32, Int16, Byte[])

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Écrit une entrée avec le texte du message, l’identificateur d’événement défini par l’application et la catégorie définie par l’application dans le journal des événements (à l’aide de la source d’événement inscrite spécifiée) et ajoute des données binaires au message.

public:
 static void WriteEntry(System::String ^ source, System::String ^ message, System::Diagnostics::EventLogEntryType type, int eventID, short category, cli::array <System::Byte> ^ rawData);

public static void WriteEntry(string source, string message, System.Diagnostics.EventLogEntryType type, int eventID, short category, byte[] rawData);

static member WriteEntry : string * string * System.Diagnostics.EventLogEntryType * int * int16 * byte[] -> unit

Public Shared Sub WriteEntry (source As String, message As String, type As EventLogEntryType, eventID As Integer, category As Short, rawData As Byte())

Paramètres

source: String

Source par laquelle l’application est inscrite sur l’ordinateur spécifié.

message: String

Chaîne à écrire dans le journal des événements.

type: EventLogEntryType

Une des EventLogEntryType valeurs.

eventID: Int32

Identificateur spécifique à l’application pour l’événement.

category: Int16

Sous-catégorie spécifique à l’application associée au message.

rawData: Byte[]

Tableau d’octets qui contient les données binaires associées à l’entrée.

Exceptions

ArgumentException

La source valeur est une chaîne vide (« »).

- ou -

La source valeur est null.

- ou -

eventID est inférieur à zéro ou supérieur à UInt16.MaxValue.

- ou -

La chaîne de message est supérieure à 31 839 octets (32 766 octets sur les systèmes d’exploitation Windows avant Windows Vista).

- ou -

Le nom de la source génère un chemin de clé de Registre de plus de 254 caractères.

InvalidEnumArgumentException

type n’est pas valide EventLogEntryType.

InvalidOperationException

Impossible d’ouvrir la clé de Registre pour le journal des événements.

Win32Exception

Le système d’exploitation a signalé une erreur lors de l’écriture de l’entrée d’événement dans le journal des événements. Un code d’erreur Windows n’est pas disponible.

Exemples

//Create a byte array for binary data to associate with the entry.
byte[] myByte = new byte[10];
//Populate the byte array with simulated data.
for (int i = 0; i < 10; i++)
{
    myByte[i] = (byte)(i % 2);
}
// Write an entry to the event log that includes associated binary data.
Console.WriteLine("Write from second source ");
EventLog.WriteEntry("SecondSource", "Writing warning to event log.",
                     EventLogEntryType.Error, myEventID, myCategory, myByte);

' Create a byte array for binary data to associate with the entry.
Dim myByte(9) As Byte
Dim i As Integer
' Populate the byte array with simulated data.
For i = 0 To 9
    myByte(i) = CByte(i Mod 2)
Next i
' Write an entry to the event log that includes associated binary data.
Console.WriteLine("Write from second source ")
EventLog.WriteEntry("SecondSource", "Writing warning to event log.", _
                     EventLogEntryType.Error, myEventID, myCategory, myByte)

Remarques

Utilisez cette méthode pour écrire des données spécifiques à l’événement définies par l’application dans le journal des événements, à l’aide d’une source déjà inscrite en tant que source d’événement pour le journal approprié. L’Observateur d’événements n’interprète pas ces données ; il affiche les données brutes uniquement dans un format hexadécimal et texte combiné. Utilisez des données spécifiques aux événements de manière éparse ; incluez-le uniquement si vous êtes sûr qu’il sera utile. Vous pouvez également utiliser des données spécifiques à l’événement pour stocker les informations que l’application peut traiter indépendamment de l’Observateur d’événements. Par exemple, vous pouvez écrire une visionneuse spécifiquement pour vos événements, ou écrire un programme qui analyse le fichier journal et crée des rapports qui incluent des informations à partir des données spécifiques à l’événement.

Outre les données binaires, vous pouvez spécifier une catégorie définie par l’application et un identificateur d’événement défini par l’application. L’Observateur d’événements utilise la catégorie pour filtrer les événements écrits par une source d’événement. L’Observateur d’événements peut afficher la catégorie sous forme de valeur numérique ou utiliser la catégorie comme identificateur de ressource pour afficher une chaîne de catégorie localisée.

Note

Le category paramètre doit être une valeur positive. Les valeurs de catégorie négatives apparaissent sous la forme d’un nombre positif complémentaire dans l’Observateur d’événements. Par exemple, une -10 apparaît sous la forme 65 526, une -1 de 65 535.

Pour afficher les chaînes de catégorie localisées dans l’Observateur d’événements, vous devez utiliser une source d’événement configurée avec un fichier de ressource de catégorie et définir l’identificateur category de ressource dans le fichier de ressources de catégorie. Si la source d’événement n’a pas de fichier de ressource de catégorie configuré ou si elle category n’indexe pas de chaîne dans le fichier de ressources de catégorie, l’Observateur d’événements affiche la valeur de catégorie numérique pour cette entrée. Configurez le fichier de ressources de catégorie, ainsi que le nombre de chaînes de catégorie dans le fichier de ressources, à l’aide de la EventLogInstaller classe ou de la EventSourceCreationData classe.

Identificateurs d’événement, ainsi que la source d’événement, identifient de manière unique un événement. Chaque application peut définir ses propres événements numérotés et les chaînes de description auxquelles elles sont mappées. Les visionneuses d’événements affichent ces valeurs de chaîne pour aider l’utilisateur à comprendre ce qui s’est passé et suggérer les actions à entreprendre.

Enfin, vous pouvez spécifier un EventLogEntryType événement écrit dans le journal des événements. Il type est indiqué par une icône et un texte dans la colonne Type dans l’Observateur d’événements pour un journal. Ce paramètre indique si le type d’événement est une erreur, un avertissement, des informations, un audit de réussite ou un audit d’échec.

Vous devez créer et configurer la source d’événement avant d’écrire la première entrée avec la source. Créez la source d’événement pendant l’installation de votre application. Cela permet au système d’exploitation d’actualiser sa liste de sources d’événements inscrites et de leur configuration. Si le système d’exploitation n’a pas actualisé sa liste de sources d’événements et que vous tentez d’écrire un événement avec la nouvelle source, l’opération d’écriture échoue. Vous pouvez configurer une nouvelle source à l’aide d’une EventLogInstallerou de la CreateEventSource méthode. Vous devez disposer de droits d’administration sur l’ordinateur pour créer une source d’événement.

La source doit être configurée pour écrire des entrées localisées ou pour écrire des chaînes directes. La WriteEntry méthode écrit la chaîne donnée directement dans le journal des événements ; elle n’utilise pas de fichier de ressource de message localisable. Utilisez la méthode pour écrire des événements à l’aide WriteEvent d’un fichier de ressources de message localisé.

Si votre application écrit des entrées à l’aide des identificateurs de ressource et des valeurs de chaîne, vous devez inscrire deux sources distinctes. Par exemple, configurez une source avec des fichiers de ressources, puis utilisez cette source dans la WriteEvent méthode pour écrire des entrées à l’aide d’identificateurs de ressource dans le journal des événements. Créez ensuite une autre source sans fichiers de ressources et utilisez cette source dans la WriteEntry méthode pour écrire des chaînes directement dans le journal des événements à l’aide de cette source.

Note

Si le message paramètre contient un caractère NUL, le message dans le journal des événements est arrêté au niveau du caractère NUL.

La message chaîne ne peut pas contenir %n, où n est une valeur entière (par exemple, %1), car la visionneuse d’événements la traite comme une chaîne d’insertion. Étant donné qu’une adresse IPv6 (Internet Protocol), version 6 (IPv6) peut contenir cette séquence de caractères, vous ne pouvez pas consigner un message d’événement qui contient une adresse IPv6.

Voir aussi

S’applique à

WriteEntry(String, String, EventLogEntryType, Int32, Int16)

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Écrit une entrée avec le texte du message, l’identificateur d’événement défini par l’application et la catégorie définie par l’application dans le journal des événements, à l’aide de la source d’événement inscrite spécifiée. Vous category pouvez l’utiliser par l’Observateur d’événements pour filtrer les événements dans le journal.

public:
 static void WriteEntry(System::String ^ source, System::String ^ message, System::Diagnostics::EventLogEntryType type, int eventID, short category);

public static void WriteEntry(string source, string message, System.Diagnostics.EventLogEntryType type, int eventID, short category);

static member WriteEntry : string * string * System.Diagnostics.EventLogEntryType * int * int16 -> unit

Public Shared Sub WriteEntry (source As String, message As String, type As EventLogEntryType, eventID As Integer, category As Short)

Paramètres

source: String

Source par laquelle l’application est inscrite sur l’ordinateur spécifié.

message: String

Chaîne à écrire dans le journal des événements.

type: EventLogEntryType

Une des EventLogEntryType valeurs.

eventID: Int32

Identificateur spécifique à l’application pour l’événement.

category: Int16

Sous-catégorie spécifique à l’application associée au message.

Exceptions

ArgumentException

La source valeur est une chaîne vide (« »).

- ou -

La source valeur est null.

- ou -

eventID est inférieur à zéro ou supérieur à UInt16.MaxValue.

- ou -

La chaîne de message est supérieure à 31 839 octets (32 766 octets sur les systèmes d’exploitation Windows avant Windows Vista).

- ou -

Le nom de la source génère un chemin de clé de Registre de plus de 254 caractères.

InvalidOperationException

Impossible d’ouvrir la clé de Registre pour le journal des événements.

InvalidEnumArgumentException

type n’est pas valide EventLogEntryType.

Win32Exception

Le système d’exploitation a signalé une erreur lors de l’écriture de l’entrée d’événement dans le journal des événements. Un code d’erreur Windows n’est pas disponible.

Exemples

int myEventID = 20;
short myCategory = 10;
// Write an informational entry to the event log.
Console.WriteLine("Write from first source ");
EventLog.WriteEntry("FirstSource", "Writing warning to event log.",
                     EventLogEntryType.Information, myEventID, myCategory);

Dim myEventID As Integer = 10
Dim myCategory As Short = 20
' Write an informational entry to the event log.
Console.WriteLine("Write from first source ")
EventLog.WriteEntry("FirstSource", "Writing warning to event log.", _
                           EventLogEntryType.Information, myEventID, myCategory)

Remarques

Utilisez cette méthode pour écrire une entrée avec une application définie category dans le journal des événements, à l’aide d’une source déjà inscrite en tant que source d’événement pour le journal approprié. L’Observateur d’événements utilise la catégorie pour filtrer les événements écrits par une source d’événement. L’Observateur d’événements peut afficher la catégorie sous forme de valeur numérique ou utiliser la catégorie comme identificateur de ressource pour afficher une chaîne de catégorie localisée.

Note

Outre la catégorie, vous pouvez spécifier un identificateur d’événement pour l’événement en cours d’écriture dans le journal des événements. Identificateurs d’événement, ainsi que la source d’événement, identifient de manière unique un événement. Chaque application peut définir ses propres événements numérotés et les chaînes de description auxquelles elles sont mappées. Les visionneuses d’événements affichent ces valeurs de chaîne pour aider l’utilisateur à comprendre ce qui s’est passé et suggérer les actions à entreprendre.

Note

Si le message paramètre contient un caractère NUL, le message dans le journal des événements est arrêté au niveau du caractère NUL.

Voir aussi

S’applique à

WriteEntry(String, EventLogEntryType, Int32, Int16, Byte[])

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Écrit une entrée avec le texte du message donné, l’identificateur d’événement défini par l’application et la catégorie définie par l’application dans le journal des événements et ajoute des données binaires au message.

public:
 void WriteEntry(System::String ^ message, System::Diagnostics::EventLogEntryType type, int eventID, short category, cli::array <System::Byte> ^ rawData);

public void WriteEntry(string message, System.Diagnostics.EventLogEntryType type, int eventID, short category, byte[] rawData);

member this.WriteEntry : string * System.Diagnostics.EventLogEntryType * int * int16 * byte[] -> unit

Public Sub WriteEntry (message As String, type As EventLogEntryType, eventID As Integer, category As Short, rawData As Byte())

Paramètres

message: String

Chaîne à écrire dans le journal des événements.

type: EventLogEntryType

Une des EventLogEntryType valeurs.

eventID: Int32

Identificateur spécifique à l’application pour l’événement.

category: Int16

Sous-catégorie spécifique à l’application associée au message.

rawData: Byte[]

Tableau d’octets qui contient les données binaires associées à l’entrée.

Exceptions

ArgumentException

La Source propriété du fichier EventLog n’a pas été définie.

- ou -

La méthode a tenté d’inscrire une nouvelle source d’événement, mais le nom de l’ordinateur n’est MachineName pas valide.

- ou -

La source est déjà inscrite pour un autre journal des événements.

- ou -

eventID est inférieur à zéro ou supérieur à UInt16.MaxValue.

- ou -

La chaîne de message est supérieure à 31 839 octets (32 766 octets sur les systèmes d’exploitation Windows avant Windows Vista).

- ou -

Le nom de la source génère un chemin de clé de Registre de plus de 254 caractères.

InvalidOperationException

Impossible d’ouvrir la clé de Registre pour le journal des événements.

InvalidEnumArgumentException

type n’est pas valide EventLogEntryType.

Win32Exception

Le système d’exploitation a signalé une erreur lors de l’écriture de l’entrée d’événement dans le journal des événements. Un code d’erreur Windows n’est pas disponible.

Exemples

// Create the source, if it does not already exist.
string myLogName = "myNewLog";
if(!EventLog.SourceExists("MySource"))
{
   // An event log source should not be created and immediately used.
   // There is a latency time to enable the source, it should be created
   // prior to executing the application that uses the source.
   // Execute this sample a second time to use the new source.
   EventLog.CreateEventSource("MySource", myLogName);
   Console.WriteLine("Created EventSource");
   Console.WriteLine("Exiting, execute the application a second time to use the source.");
   return;
}
else
   {
       myLogName = EventLog.LogNameFromSourceName("MySource",".");
   }
   // Create an EventLog and assign source.
   EventLog myEventLog = new EventLog();
myEventLog.Source = "MySource";
myEventLog.Log = myLogName;

// Set the 'description' for the event.
string myMessage = "This is my event.";
EventLogEntryType myEventLogEntryType = EventLogEntryType.Warning;
int myApplicatinEventId = 1100;
short myApplicatinCategoryId = 1;

// Set the 'data' for the event.
byte[] myRawData = new byte[4];
for(int i=0;i<4;i++)
{
   myRawData[i]=1;
}
// Write the entry in the event log.
Console.WriteLine("Writing to EventLog.. ");
myEventLog.WriteEntry(myMessage,myEventLogEntryType,
   myApplicatinEventId, myApplicatinCategoryId, myRawData);

' Create the source, if it does not already exist.
dim myLogName as string = "myNewLog"
If Not EventLog.SourceExists("MySource") Then
   EventLog.CreateEventSource("MySource", myLogName)
   Console.WriteLine("Creating EventSource")
else
   myLogName = EventLog.LogNameFromSourceName("MySource",".")
End If

' Create an EventLog and assign source.
Dim myEventLog As New EventLog()
myEventLog.Source = "MySource"
myEventLog.Log = myLogName

' Set the 'description' for the event.
Dim myMessage As String = "This is my event."
Dim myEventLogEntryType As EventLogEntryType = EventLogEntryType.Warning
Dim myApplicatinEventId As Integer = 1100
Dim myApplicatinCategoryId As Short = 1

' Set the 'data' for the event.
Dim myRawData(3) As Byte
Dim i As Integer
For i = 0 To 3
   myRawData(i) = 1
Next i
' Write the entry in the event log.
Console.WriteLine("Writing to EventLog.. ")
myEventLog.WriteEntry(myMessage, myEventLogEntryType, myApplicatinEventId, _
                     myApplicatinCategoryId, myRawData)

Remarques

Utilisez cette surcharge pour écrire des données spécifiques à l’événement définies par l’application dans le journal des événements. L’Observateur d’événements n’interprète pas ces données ; il affiche les données brutes uniquement dans un format hexadécimal et texte combiné. Utilisez des données spécifiques à l’événement avec parcimonie, y compris uniquement si vous êtes sûr qu’il sera utile à quelqu’un qui débogue le problème. Vous pouvez également utiliser des données spécifiques à l’événement pour stocker les informations que l’application peut traiter indépendamment de l’Observateur d’événements. Par exemple, vous pouvez écrire une visionneuse spécifiquement pour vos événements, ou écrire un programme qui analyse le fichier journal et crée des rapports qui incluent des informations à partir des données spécifiques à l’événement.

Note

Vous devez définir la Source propriété sur votre EventLog composant avant de pouvoir écrire des entrées dans le journal. Vous devez créer et configurer la source d’événement avant d’écrire la première entrée avec la source.

Créez la source d’événement pendant l’installation de votre application. Cela permet au système d’exploitation d’actualiser sa liste de sources d’événements inscrites et de leur configuration. Si le système d’exploitation n’a pas actualisé sa liste de sources d’événements et que vous tentez d’écrire un événement avec la nouvelle source, l’opération d’écriture échoue. Vous pouvez configurer une nouvelle source à l’aide d’une EventLogInstallerou de la CreateEventSource méthode. Vous devez disposer de droits d’administration sur l’ordinateur pour créer une source d’événement.

Si la source spécifiée dans la Source propriété de cette EventLog instance n’est pas inscrite sur l’ordinateur dans lequel votre composant écrit, WriteEntry appelle CreateEventSource et inscrit la source.

Note

Si vous ne spécifiez pas d’instance MachineName EventLog avant d’appeler CreateEventSource ou WriteEntry, l’ordinateur local (« . ») est supposé.

Si le système doit inscrire le Source par le biais d’un appel et WriteEntry que la Log propriété n’a pas été définie sur votre EventLog instance, le journal est défini par défaut dans le journal des applications.

Note

De nombreuses exceptions répertoriées ci-dessus sont générées par des erreurs générées pendant le processus d’inscription du Source.

Note

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 l’ordinateur distant n’exécute pas le .NET Framework.

Note

Si le message paramètre contient un caractère NUL, le message dans le journal des événements est arrêté au niveau du caractère NUL.

Voir aussi

S’applique à

WriteEntry(String, String, EventLogEntryType, Int32)

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Écrit une entrée avec le texte du message donné et l’identificateur d’événement défini par l’application dans le journal des événements, à l’aide de la source d’événement inscrite spécifiée.

public:
 static void WriteEntry(System::String ^ source, System::String ^ message, System::Diagnostics::EventLogEntryType type, int eventID);

public static void WriteEntry(string source, string message, System.Diagnostics.EventLogEntryType type, int eventID);

static member WriteEntry : string * string * System.Diagnostics.EventLogEntryType * int -> unit

Public Shared Sub WriteEntry (source As String, message As String, type As EventLogEntryType, eventID As Integer)

Paramètres

source: String

Source par laquelle l’application est inscrite sur l’ordinateur spécifié.

message: String

Chaîne à écrire dans le journal des événements.

type: EventLogEntryType

Une des EventLogEntryType valeurs.

eventID: Int32

Identificateur spécifique à l’application pour l’événement.

Exceptions

ArgumentException

La source valeur est une chaîne vide (« »).

- ou -

La source valeur est null.

- ou -

eventID est inférieur à zéro ou supérieur à UInt16.MaxValue.

- ou -

La chaîne de message est supérieure à 31 839 octets (32 766 octets sur les systèmes d’exploitation Windows avant Windows Vista).

- ou -

Le nom de la source génère un chemin de clé de Registre de plus de 254 caractères.

InvalidOperationException

Impossible d’ouvrir la clé de Registre pour le journal des événements.

InvalidEnumArgumentException

type n’est pas valide EventLogEntryType.

Win32Exception

Le système d’exploitation a signalé une erreur lors de l’écriture de l’entrée d’événement dans le journal des événements. Un code d’erreur Windows n’est pas disponible.

Exemples

// Create the source, if it does not already exist.
if(!EventLog.SourceExists("MySource"))
{
   // An event log source should not be created and immediately used.
   // There is a latency time to enable the source, it should be created
   // prior to executing the application that uses the source.
   // Execute this sample a second time to use the new source.
   EventLog.CreateEventSource("MySource", "myNewLog");
   Console.WriteLine("Creating EventSource");
   Console.WriteLine("Exiting, execute the application a second time to use the source.");
   // The source is created.  Exit the application to allow it to be registered.
   return;
}

// Set the 'description' for the event.
string myMessage = "This is my event.";
EventLogEntryType myEventLogEntryType = EventLogEntryType.Warning;
int myApplicationEventId = 100;

// Write the entry in the event log.
Console.WriteLine("Writing to EventLog.. ");
EventLog.WriteEntry("MySource",myMessage,
   myEventLogEntryType, myApplicationEventId);

' Create the source, if it does not already exist.
If Not EventLog.SourceExists("MySource") Then
   EventLog.CreateEventSource("MySource", "myNewLog")
   Console.WriteLine("Creating EventSource")
End If

' Set the 'description' for the event.
Dim myMessage As String = "This is my event."
Dim myEventLogEntryType As EventLogEntryType = EventLogEntryType.Warning
Dim myApplicationEventId As Integer = 100

' Write the entry in the event log.
Console.WriteLine("Writing to EventLog.. ")
EventLog.WriteEntry("MySource", myMessage, myEventLogEntryType, myApplicationEventId)

Remarques

Utilisez cette méthode pour écrire une entrée avec une application définie eventID dans le journal des événements, à l’aide d’une source déjà inscrite en tant que source d’événement pour le journal approprié. Le eventID, ainsi que la source, identifient de manière unique un événement. Chaque application peut définir ses propres événements numérotés et les chaînes de description auxquelles elles sont mappées. Les visionneuses d’événements présentent ces chaînes à l’utilisateur pour aider l’utilisateur à comprendre ce qui s’est passé et suggérer les actions à entreprendre.

Note

Outre l’identificateur d’événement, cette surcharge vous permet de WriteEntry spécifier un EventLogEntryType événement écrit dans le journal des événements. Il type est indiqué par une icône et un texte dans la colonne Type dans l’Observateur d’événements pour un journal. Ce paramètre indique si le type d’événement est une erreur, un avertissement, des informations, un audit de réussite ou un audit d’échec.

Note

Si le message paramètre contient un caractère NUL, le message dans le journal des événements est arrêté au niveau du caractère NUL.

Voir aussi

S’applique à

WriteEntry(String, EventLogEntryType, Int32, Int16)

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Écrit une entrée avec le texte du message donné, l’identificateur d’événement défini par l’application et la catégorie définie par l’application dans le journal des événements.

public:
 void WriteEntry(System::String ^ message, System::Diagnostics::EventLogEntryType type, int eventID, short category);

public void WriteEntry(string message, System.Diagnostics.EventLogEntryType type, int eventID, short category);

member this.WriteEntry : string * System.Diagnostics.EventLogEntryType * int * int16 -> unit

Public Sub WriteEntry (message As String, type As EventLogEntryType, eventID As Integer, category As Short)

Paramètres

message: String

Chaîne à écrire dans le journal des événements.

type: EventLogEntryType

Une des EventLogEntryType valeurs.

eventID: Int32

Identificateur spécifique à l’application pour l’événement.

category: Int16

Sous-catégorie spécifique à l’application associée au message.

Exceptions

ArgumentException

La Source propriété du fichier EventLog n’a pas été définie.

- ou -

La méthode a tenté d’inscrire une nouvelle source d’événement, mais le nom de l’ordinateur n’est MachineName pas valide.

- ou -

La source est déjà inscrite pour un autre journal des événements.

- ou -

eventID est inférieur à zéro ou supérieur à UInt16.MaxValue.

- ou -

La chaîne de message est supérieure à 31 839 octets (32 766 octets sur les systèmes d’exploitation Windows avant Windows Vista).

- ou -

Le nom de la source génère un chemin de clé de Registre de plus de 254 caractères.

InvalidOperationException

Impossible d’ouvrir la clé de Registre pour le journal des événements.

InvalidEnumArgumentException

type n’est pas valide EventLogEntryType.

Win32Exception

Le système d’exploitation a signalé une erreur lors de l’écriture de l’entrée d’événement dans le journal des événements. Un code d’erreur Windows n’est pas disponible.

Exemples

// Create an EventLog instance and assign its source.
EventLog myLog = new EventLog();
myLog.Source = "ThirdSource";

// Write an informational entry to the event log.
Console.WriteLine("Write from third source ");
myLog.WriteEntry("Writing warning to event log.",
                  EventLogEntryType.Warning, myEventID, myCategory);

' Create an EventLog instance and assign its source.
Dim myLog As New EventLog()
myLog.Source = "ThirdSource"

' Write an informational entry to the event log.
Console.WriteLine("Write from third source ")
myLog.WriteEntry("Writing warning to event log.", EventLogEntryType.Warning, _
                     myEventID, myCategory)

Remarques

Utilisez cette méthode pour écrire une entrée avec une application définie category dans le journal des événements. L’Observateur d’événements utilise la catégorie pour filtrer les événements écrits par une source d’événement. L’Observateur d’événements peut afficher la catégorie sous forme de valeur numérique ou utiliser la catégorie comme identificateur de ressource pour afficher une chaîne de catégorie localisée.

Note

Si vous ne spécifiez pas d’instance MachineName EventLog avant d’appeler CreateEventSource ou WriteEntry, l’ordinateur local (« . ») est supposé.

Note

De nombreuses exceptions répertoriées ci-dessus sont générées par des erreurs générées pendant le processus d’inscription du Source.

Note

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 l’ordinateur distant n’exécute pas le .NET Framework.

Note

Si le message paramètre contient un caractère NUL, le message dans le journal des événements est arrêté au niveau du caractère NUL.

Voir aussi

S’applique à

WriteEntry(String, EventLogEntryType)

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Écrit une erreur, un avertissement, des informations, un audit de réussite ou une entrée d’audit d’échec avec le texte du message donné dans le journal des événements.

public:
 void WriteEntry(System::String ^ message, System::Diagnostics::EventLogEntryType type);

public void WriteEntry(string message, System.Diagnostics.EventLogEntryType type);

member this.WriteEntry : string * System.Diagnostics.EventLogEntryType -> unit

Public Sub WriteEntry (message As String, type As EventLogEntryType)

Paramètres

message: String

Chaîne à écrire dans le journal des événements.

type: EventLogEntryType

Une des EventLogEntryType valeurs.

Exceptions

ArgumentException

La Source propriété du fichier EventLog n’a pas été définie.

- ou -

La méthode a tenté d’inscrire une nouvelle source d’événement, mais le nom de l’ordinateur n’est MachineName pas valide.

- ou -

La source est déjà inscrite pour un autre journal des événements.

- ou -

La chaîne de message est supérieure à 31 839 octets (32 766 octets sur les systèmes d’exploitation Windows avant Windows Vista).

- ou -

Le nom de la source génère un chemin de clé de Registre de plus de 254 caractères.

InvalidEnumArgumentException

type n’est pas valide EventLogEntryType.

InvalidOperationException

Impossible d’ouvrir la clé de Registre pour le journal des événements.

Win32Exception

Le système d’exploitation a signalé une erreur lors de l’écriture de l’entrée d’événement dans le journal des événements. Un code d’erreur Windows n’est pas disponible.

Exemples

L’exemple suivant écrit une entrée d’avertissement dans un journal des événements, « MyNewLog », sur l’ordinateur local.

using System;
using System.Diagnostics;
using System.Threading;

class MySample1
{

    public static void Main()
    {

        // Create an EventLog instance and assign its source.
        EventLog myLog = new EventLog("MyNewLog");
        myLog.Source = "MyNewLogSource";

        // Write an informational entry to the event log.
        myLog.WriteEntry("Writing warning to event log.", EventLogEntryType.Warning);
    }
}

Option Strict
Option Explicit

Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        ' Create an EventLog instance and assign its source.
        Dim myLog As New EventLog("MyNewLog")
        myLog.Source = "MyNewLogSource"
        
        ' Write an informational entry to the event log.    
        myLog.WriteEntry("Writing warning to event log.", EventLogEntryType.Warning)
    End Sub
End Class

Remarques

Utilisez cette méthode pour écrire une entrée d’un spécifié EventLogEntryType dans le journal des événements. Il type est indiqué par une icône et un texte dans la colonne Type dans l’Observateur d’événements pour un journal.

Note

Si vous ne spécifiez pas d’instance MachineName EventLog avant d’appeler CreateEventSource ou WriteEntry, l’ordinateur local (« . ») est supposé.

Note

De nombreuses exceptions répertoriées ci-dessus sont générées par des erreurs générées pendant le processus d’inscription du Source.

Note

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 l’ordinateur distant n’exécute pas le .NET Framework.

Note

Si le message paramètre contient un caractère NUL, le message dans le journal des événements est arrêté au niveau du caractère NUL.

Voir aussi

S’applique à

WriteEntry(String, EventLogEntryType, Int32)

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Écrit une entrée avec le texte du message donné et l’identificateur d’événement défini par l’application dans le journal des événements.

public:
 void WriteEntry(System::String ^ message, System::Diagnostics::EventLogEntryType type, int eventID);

public void WriteEntry(string message, System.Diagnostics.EventLogEntryType type, int eventID);

member this.WriteEntry : string * System.Diagnostics.EventLogEntryType * int -> unit

Public Sub WriteEntry (message As String, type As EventLogEntryType, eventID As Integer)

Paramètres

message: String

Chaîne à écrire dans le journal des événements.

type: EventLogEntryType

Une des EventLogEntryType valeurs.

eventID: Int32

Identificateur spécifique à l’application pour l’événement.

Exceptions

ArgumentException

La Source propriété du fichier EventLog n’a pas été définie.

- ou -

La méthode a tenté d’inscrire une nouvelle source d’événement, mais le nom de l’ordinateur n’est MachineName pas valide.

- ou -

La source est déjà inscrite pour un autre journal des événements.

- ou -

eventID est inférieur à zéro ou supérieur à UInt16.MaxValue.

- ou -

La chaîne de message est supérieure à 31 839 octets (32 766 octets sur les systèmes d’exploitation Windows avant Windows Vista).

- ou -

Le nom de la source génère un chemin de clé de Registre de plus de 254 caractères.

InvalidOperationException

Impossible d’ouvrir la clé de Registre pour le journal des événements.

InvalidEnumArgumentException

type n’est pas valide EventLogEntryType.

Win32Exception

Le système d’exploitation a signalé une erreur lors de l’écriture de l’entrée d’événement dans le journal des événements. Un code d’erreur Windows n’est pas disponible.

Exemples

// Create an EventLog instance and assign its source.
EventLog myLog = new EventLog();
myLog.Source = "ThirdSource";

// Write an informational entry to the event log.
Console.WriteLine("Write from third source ");
myLog.WriteEntry("Writing warning to event log.",
                  EventLogEntryType.Warning, myEventID, myCategory);

' Create an EventLog instance and assign its source.
Dim myLog As New EventLog()
myLog.Source = "ThirdSource"

' Write an informational entry to the event log.
Console.WriteLine("Write from third source ")
myLog.WriteEntry("Writing warning to event log.", EventLogEntryType.Warning, _
                     myEventID, myCategory)

Remarques

Utilisez cette méthode pour écrire une entrée avec une application définie eventID dans le journal des événements. Ensemble eventID avec la source, identifiez un événement de manière unique. Chaque application peut définir ses propres événements numérotés et les chaînes de description auxquelles elles sont mappées. Les visionneuses d’événements affichent ces valeurs de chaîne pour aider l’utilisateur à comprendre ce qui s’est passé et suggérer les actions à entreprendre.

Note

En plus de l’identificateur d’événement, vous pouvez spécifier un EventLogEntryType événement écrit dans le journal des événements. Il type est indiqué par une icône et un texte dans la colonne Type dans l’Observateur d’événements pour un journal. Ce paramètre indique si le type d’événement est une erreur, un avertissement, des informations, un audit de réussite ou un audit d’échec.

Note

Si vous ne spécifiez pas d’instance MachineName EventLog avant d’appeler CreateEventSource ou WriteEntry, l’ordinateur local (« . ») est supposé.

Note

De nombreuses exceptions répertoriées ci-dessus sont générées par des erreurs générées pendant le processus d’inscription du Source.

Note

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 l’ordinateur distant n’exécute pas le .NET Framework.

Note

Si le message paramètre contient un caractère NUL, le message dans le journal des événements est arrêté au niveau du caractère NUL.

Voir aussi

S’applique à

WriteEntry(String, String)

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Écrit une entrée de type d’informations avec le texte du message donné dans le journal des événements, à l’aide de la source d’événement inscrite spécifiée.

public:
 static void WriteEntry(System::String ^ source, System::String ^ message);

public static void WriteEntry(string source, string message);

static member WriteEntry : string * string -> unit

Public Shared Sub WriteEntry (source As String, message As String)

Paramètres

source: String

Source par laquelle l’application est inscrite sur l’ordinateur spécifié.

message: String

Chaîne à écrire dans le journal des événements.

Exceptions

ArgumentException

La source valeur est une chaîne vide (« »).

- ou -

La source valeur est null.

- ou -

La chaîne de message est supérieure à 31 839 octets (32 766 octets sur les systèmes d’exploitation Windows avant Windows Vista).

- ou -

Le nom de la source génère un chemin de clé de Registre de plus de 254 caractères.

InvalidOperationException

Impossible d’ouvrir la clé de Registre pour le journal des événements.

Win32Exception

Le système d’exploitation a signalé une erreur lors de l’écriture de l’entrée d’événement dans le journal des événements. Un code d’erreur Windows n’est pas disponible.

Exemples

L’exemple suivant crée la source MySource s’il n’existe pas déjà et écrit une entrée dans le journal MyNewLogdes événements.

using System;
using System.Diagnostics;
using System.Threading;

class MySample
{

    public static void Main()
    {

        // Create the source, if it does not already exist.
        if (!EventLog.SourceExists("MySource"))
        {
            // An event log source should not be created and immediately used.
            // There is a latency time to enable the source, it should be created
            // prior to executing the application that uses the source.
            // Execute this sample a second time to use the new source.
            EventLog.CreateEventSource("MySource", "myNewLog");
            Console.WriteLine("CreatingEventSource");
            Console.WriteLine("Exiting, execute the application a second time to use the source.");
            // The source is created.  Exit the application to allow it to be registered.
            return;
        }

        // Write an informational entry to the event log.
        EventLog.WriteEntry("MySource", "Writing to event log.");
    }
}

Option Strict
Option Explicit

Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        ' Create the source, if it does not already exist.
        If Not EventLog.SourceExists("MySource") Then
            EventLog.CreateEventSource("MySource", "myNewLog")
            Console.WriteLine("CreatingEventSource")
        End If
        
        
        ' Write an informational entry to the event log.    
        EventLog.WriteEntry("MySource", "Writing to event log.")
    End Sub
End Class

Remarques

Utilisez cette méthode pour écrire une entrée d’informations dans le journal des événements, à l’aide d’une source déjà inscrite en tant que source d’événement pour le journal approprié. Si vous souhaitez spécifier un autre EventLogEntryType, utilisez une surcharge différente de WriteEntry.

Note

Si le message paramètre contient un caractère NUL, le message dans le journal des événements est arrêté au niveau du caractère NUL.

Voir aussi

S’applique à

WriteEntry(String)

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Écrit une entrée de type d’informations, avec le texte du message donné, dans le journal des événements.

public:
 void WriteEntry(System::String ^ message);

public void WriteEntry(string message);

member this.WriteEntry : string -> unit

Public Sub WriteEntry (message As String)

Paramètres

message: String

Chaîne à écrire dans le journal des événements.

Exceptions

ArgumentException

La Source propriété du fichier EventLog n’a pas été définie.

- ou -

La méthode a tenté d’inscrire une nouvelle source d’événement, mais le nom de l’ordinateur n’est MachineName pas valide.

- ou -

La source est déjà inscrite pour un autre journal des événements.

- ou -

La chaîne de message est supérieure à 31 839 octets (32 766 octets sur les systèmes d’exploitation Windows avant Windows Vista).

- ou -

Le nom de la source génère un chemin de clé de Registre de plus de 254 caractères.

InvalidOperationException

Impossible d’ouvrir la clé de Registre pour le journal des événements.

Win32Exception

Le système d’exploitation a signalé une erreur lors de l’écriture de l’entrée d’événement dans le journal des événements. Un code d’erreur Windows n’est pas disponible.

Exemples

L’exemple suivant crée la source MySource s’il n’existe pas déjà et écrit une entrée dans le journal MyNewLogdes événements.

using System;
using System.Diagnostics;
using System.Threading;

class MySample{

    public static void Main(){

        // Create the source, if it does not already exist.
        if(!EventLog.SourceExists("MySource"))
        {
             //An event log source should not be created and immediately used.
             //There is a latency time to enable the source, it should be created
             //prior to executing the application that uses the source.
             //Execute this sample a second time to use the new source.
            EventLog.CreateEventSource("MySource", "MyNewLog");
            Console.WriteLine("CreatedEventSource");
            Console.WriteLine("Exiting, execute the application a second time to use the source.");
            // The source is created.  Exit the application to allow it to be registered.
            return;
        }

        // 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 to event log.");
    }
}

Option Explicit
Option Strict

Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        
        If Not EventLog.SourceExists("MySource") Then
            ' Create the source, if it does not already exist.
            ' An event log source should not be created and immediately used.
            ' There is a latency time to enable the source, it should be created
            ' prior to executing the application that uses the source.
            ' Execute this sample a second time to use the new source.
            EventLog.CreateEventSource("MySource", "MyNewLog")
            Console.WriteLine("CreatingEventSource")
            'The source is created.  Exit the application to allow it to be registered.
            Return
        End If
        
        ' Create an EventLog instance and assign its source.
        Dim myLog As New EventLog()
        myLog.Source = "MySource"
        
        ' Write an informational entry to the event log.    
        myLog.WriteEntry("Writing to event log.")
    End Sub
End Class

Remarques

Utilisez cette méthode pour écrire une entrée d’informations dans le journal des événements associé à cette EventLog instance. Si vous souhaitez spécifier un autre EventLogEntryType, utilisez une surcharge différente de WriteEntry.

Note

Si vous ne spécifiez pas d’instance MachineName EventLog avant d’appeler CreateEventSource ou WriteEntry, l’ordinateur local (« . ») est supposé.

Note

La plupart des exceptions répertoriées ci-dessus sont générées par des erreurs générées pendant le processus d’inscription du Source.

Note

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 l’ordinateur distant n’exécute pas le .NET Framework.

Note

Si le message paramètre contient un caractère NUL, le message dans le journal des événements est arrêté au niveau du caractère NUL.

Voir aussi

S’applique à

WriteEntry(String, String, EventLogEntryType)

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Source:: EventLog.cs

Écrit une erreur, un avertissement, des informations, un audit de réussite ou une entrée d’audit d’échec avec le texte du message donné dans le journal des événements, à l’aide de la source d’événement inscrite spécifiée.

public:
 static void WriteEntry(System::String ^ source, System::String ^ message, System::Diagnostics::EventLogEntryType type);

public static void WriteEntry(string source, string message, System.Diagnostics.EventLogEntryType type);

static member WriteEntry : string * string * System.Diagnostics.EventLogEntryType -> unit

Public Shared Sub WriteEntry (source As String, message As String, type As EventLogEntryType)

Paramètres

source: String

Source par laquelle l’application est inscrite sur l’ordinateur spécifié.

message: String

Chaîne à écrire dans le journal des événements.

type: EventLogEntryType

Une des EventLogEntryType valeurs.

Exceptions

ArgumentException

La source valeur est une chaîne vide (« »).

- ou -

La source valeur est null.

- ou -

La chaîne de message est supérieure à 31 839 octets (32 766 octets sur les systèmes d’exploitation Windows avant Windows Vista).

- ou -

Le nom de la source génère un chemin de clé de Registre de plus de 254 caractères.

InvalidOperationException

Impossible d’ouvrir la clé de Registre pour le journal des événements.

InvalidEnumArgumentException

type n’est pas valide EventLogEntryType.

Win32Exception

Le système d’exploitation a signalé une erreur lors de l’écriture de l’entrée d’événement dans le journal des événements. Un code d’erreur Windows n’est pas disponible.

Exemples

L’exemple suivant écrit une entrée d’avertissement dans un journal des événements, « MyNewLog », sur l’ordinateur local.

using System;
using System.Diagnostics;
using System.Threading;

class MySample2
{

    public static void Main()
    {

        // Write an informational entry to the event log.
        EventLog.WriteEntry("MySource",
            "Writing warning to event log.",
            EventLogEntryType.Warning);
    }
}

Option Explicit
Option Strict

Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        ' Write an informational entry to the event log.    
        EventLog.WriteEntry("MySource", "Writing warning to event log.", _
            EventLogEntryType.Warning)
    End Sub
End Class

Remarques

Utilisez cette méthode pour écrire une entrée d’un élément spécifié EventLogEntryType dans le journal des événements, à l’aide d’une source déjà inscrite en tant que source d’événement pour le journal approprié. Il type est indiqué par une icône et un texte dans la colonne Type dans l’Observateur d’événements pour un journal.

Note

Si le message paramètre contient un caractère NUL, le message dans le journal des événements est arrêté au niveau du caractère NUL.

Voir aussi

S’applique à

Commentaires

Cette page a-t-elle été utile ?

Partager via

EventLog.WriteEntry Méthode

Définition

Surcharges

WriteEntry(String, String, EventLogEntryType, Int32, Int16, Byte[])

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

WriteEntry(String, String, EventLogEntryType, Int32, Int16)

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

WriteEntry(String, EventLogEntryType, Int32, Int16, Byte[])

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

WriteEntry(String, String, EventLogEntryType, Int32)

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

WriteEntry(String, EventLogEntryType, Int32, Int16)

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

WriteEntry(String, EventLogEntryType)

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

WriteEntry(String, EventLogEntryType, Int32)

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

WriteEntry(String, String)

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

WriteEntry(String)

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

WriteEntry(String, String, EventLogEntryType)

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

Commentaires