Partage via


EventLog.WriteEntry Méthode

Définition

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

Surcharges

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

Écrit une entrée avec le texte de message donné, l'identificateur de l'é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énements 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 de message donné, l'identificateur de l'é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énements inscrite spécifiée. L'Observateur d'événements peut utiliser category pour le filtrage des événements du journal.

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

Écrit une entrée avec le texte de message donné, l'identificateur de l'é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 de message donné et l'identificateur d'événements défini par l'application, dans le journal des événements, à l'aide de la source d'événements inscrite spécifiée.

WriteEntry(String, EventLogEntryType, Int32, Int16)

Écrit une entrée avec le texte de message donné, l'identificateur de l'é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 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.

WriteEntry(String, EventLogEntryType, Int32)

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

WriteEntry(String, String)

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

WriteEntry(String)

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

WriteEntry(String, String, EventLogEntryType)

É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, à l'aide de la source d'événements inscrite spécifiée.

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

Source:
EventLog.cs
Source:
EventLog.cs
Source:
EventLog.cs

Écrit une entrée avec le texte de message donné, l'identificateur de l'é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énements 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 grâce à 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 valeurs de l'objet EventLogEntryType.

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 contenant les données binaires associées à l'entrée.

Exceptions

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

- ou -

source a la valeur null.

- ou -

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

- ou -

La chaîne de message dépasse 31 839 octets (32 766 octets sur les systèmes d'exploitation Windows antérieurs à Windows Vista).

- ou -

Le nom de source fournit un chemin d'accès de clé de Registre dépassant 254 caractères.

type n’est pas un EventLogEntryType valide.

La clé de Registre du journal des événements n'a pas pu être ouverte.

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.
array<Byte>^myByte = gcnew array<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.
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 aux événements 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énements pour le journal approprié. Le 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 les données spécifiques aux événements avec parcimonie ; l’inclure uniquement si vous êtes sûr qu’il sera utile. Vous pouvez également utiliser des données spécifiques à un événement pour stocker des informations que l’application peut traiter indépendamment du 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.

En plus des 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. Le observateur d'événements utilise la catégorie pour filtrer les événements écrits par une source d’événement. Le 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.

Notes

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 le observateur d'événements. Par exemple, un -10 s’affiche sous la forme 65 526 et un -1 comme 65 535.

Pour afficher des chaînes de catégorie localisées dans le observateur d'événements, vous devez utiliser une source d’événements configurée avec un fichier de ressources de catégorie et définir sur category un identificateur de ressource dans le fichier de ressources de catégorie. Si la source d’événement n’a pas de fichier de ressources de catégorie configuré ou si le spécifié n’indexe category pas de chaîne dans le fichier de ressources de catégorie, le observateur d'événements affiche la valeur de catégorie numérique de 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 EventLogInstallerEventSourceCreationData classe ou .

Les identificateurs d’événement, ainsi que la source de l’événement, identifient 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 ils sont mappés. Les visionneuses d’événements affichent ces valeurs de chaîne pour aider l’utilisateur à comprendre ce qui s’est mal passé et suggérer les actions à entreprendre.

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

Vous devez créer et configurer la source d’événements avant d’écrire la première entrée avec la source. Create la nouvelle source d’événement pendant l’installation de votre application. Cela laisse le temps au système d’exploitation d’actualiser sa liste des sources d’événements inscrites et 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 EventLogInstaller, ou à l’aide 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 ressources de message localisable. Utilisez la WriteEvent méthode pour écrire des événements à l’aide d’un fichier de ressources de message localisé.

Si votre application écrit des entrées à l’aide d’identificateurs de ressource et de 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 méthode pour écrire des entrées à l’aide WriteEvent d’identificateurs de ressource dans le journal des événements. Créez ensuite une autre source sans fichiers de ressources, puis 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.

Notes

Si le message paramètre contient un caractère NUL, le message dans le journal des événements se termine 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 l’observateur d’événements la traite comme une chaîne d’insertion. Étant donné qu’une adresse IPv6 (Internet Protocol, version 6) peut contenir cette séquence de caractères, vous ne pouvez pas enregistrer 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

Écrit une entrée avec le texte de message donné, l'identificateur de l'é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énements inscrite spécifiée. L'Observateur d'événements peut utiliser category pour le filtrage des événements du 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 grâce à 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 valeurs de l'objet EventLogEntryType.

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

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

- ou -

source a la valeur null.

- ou -

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

- ou -

La chaîne de message dépasse 31 839 octets (32 766 octets sur les systèmes d'exploitation Windows antérieurs à Windows Vista).

- ou -

Le nom de source fournit un chemin d'accès de clé de Registre dépassant 254 caractères.

La clé de Registre du journal des événements n'a pas pu être ouverte.

type n’est pas un EventLogEntryType valide.

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 );
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 dans category le journal des événements, à l’aide d’une source déjà inscrite en tant que source d’événements pour le journal approprié. Le observateur d'événements utilise la catégorie pour filtrer les événements écrits par une source d’événement. Le 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.

Notes

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 le observateur d'événements. Par exemple, un -10 apparaît comme 65 526, un -1 comme 65 535.

Pour afficher des chaînes de catégorie localisées dans le observateur d'événements, vous devez utiliser une source d’événements configurée avec un fichier de ressources de catégorie et définir sur category un identificateur de ressource dans le fichier de ressources de catégorie. Si la source d’événement n’a pas de fichier de ressources de catégorie configuré ou si le spécifié n’indexe category pas de chaîne dans le fichier de ressources de catégorie, le observateur d'événements affiche la valeur de catégorie numérique de 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 EventSourceCreationData .

En plus de 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. Les identificateurs d’événement, ainsi que la source de l’événement, identifient 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 ils sont mappés. Les observateurs 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 pour l’événement en cours d’écriture dans le journal des événements. le type est indiqué par une icône et du texte dans la colonne Type dans le observateur d'événements d’un journal. Ce paramètre indique si le type d’événement est erreur, avertissement, informations, audit de réussite ou audit d’échec.

Vous devez créer et configurer la source de l’événement avant d’écrire la première entrée avec la source. Create la nouvelle source d’événement lors de l’installation de votre application. Cela laisse le temps au système d’exploitation d’actualiser sa liste des sources d’événements inscrites et 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’un EventLogInstaller, ou à l’aide de la CreateEventSource méthode . Vous devez disposer des 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 ressources de message localisable. Utilisez la WriteEvent méthode pour écrire des événements à l’aide d’un fichier de ressources de message localisé.

Si votre application écrit des entrées à l’aide d’identificateurs de ressource et de 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.

Notes

Si le message paramètre contient un caractère NUL, le message dans le journal des événements se termine 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 l’observateur d’événements la traite comme une chaîne d’insertion. Étant donné qu’une adresse IPv6 (Protocole Internet version 6) peut contenir cette séquence de caractères, vous ne pouvez pas enregistrer un message d’événement qui contient une adresse IPv6.

Voir aussi

S’applique à

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

Source:
EventLog.cs
Source:
EventLog.cs
Source:
EventLog.cs

Écrit une entrée avec le texte de message donné, l'identificateur de l'é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 valeurs de l'objet EventLogEntryType.

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 contenant les données binaires associées à l'entrée.

Exceptions

La propriété Source de EventLog n'a pas été définie.

- ou -

La méthode a tenté d'inscrire un nouvel événement source, mais le nom d'ordinateur figurant dans MachineName n'est pas valide.

- ou -

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

- ou -

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

- ou -

La chaîne de message dépasse 31 839 octets (32 766 octets sur les systèmes d'exploitation Windows antérieurs à Windows Vista).

- ou -

Le nom de source fournit un chemin d'accès de clé de Registre dépassant 254 caractères.

La clé de Registre du journal des événements n'a pas pu être ouverte.

type n’est pas un EventLogEntryType valide.

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" ) )
{
   EventLog::CreateEventSource( "MySource", myLogName );
   Console::WriteLine( "Creating EventSource" );
}
else
   myLogName = EventLog::LogNameFromSourceName( "MySource", "." );

// Create an EventLog and assign source.
EventLog^ myEventLog = gcnew 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.
array<Byte>^ myRawData = gcnew array<Byte>(4);
for ( int i = 0; i < 4; i++ )
{
   myRawData[ i ] = 1;
}
Console::WriteLine( "Writing to EventLog.. " );
myEventLog->WriteEntry( myMessage, myEventLogEntryType, myApplicatinEventId, myApplicatinCategoryId, myRawData );
// 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 aux événements définis par l’application dans le journal des événements. Le observateur d'événements n’interprète pas ces données ; il affiche uniquement les données brutes dans un format hexadécimal et texte combiné. Utilisez les données spécifiques à l’événement avec parcimonie, y compris uniquement si vous êtes sûr qu’elles seront utiles à quelqu’un qui débogue le problème. Vous pouvez également utiliser des données spécifiques à l’événement pour stocker des informations que l’application peut traiter indépendamment des 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.

En plus des 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. Le observateur d'événements utilise la catégorie pour filtrer les événements écrits par une source d’événement. Le 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.

Notes

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

Notes

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 le observateur d'événements. Par exemple, un -10 apparaît comme 65 526, un -1 comme 65 535.

Pour afficher des chaînes de catégorie localisées dans le observateur d'événements, vous devez utiliser une source d’événements configurée avec un fichier de ressources de catégorie et définir sur category un identificateur de ressource dans le fichier de ressources de catégorie. Si la source d’événement n’a pas de fichier de ressources de catégorie configuré ou si le spécifié n’indexe category pas de chaîne dans le fichier de ressources de catégorie, le observateur d'événements affiche la valeur de catégorie numérique de 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 EventSourceCreationData .

Les identificateurs d’événement, ainsi que la source de l’événement, identifient 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 ils sont mappés. Les observateurs 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 pour l’événement en cours d’écriture dans le journal des événements. le type est indiqué par une icône et du texte dans la colonne Type dans le observateur d'événements d’un journal. Ce paramètre indique si le type d’événement est erreur, avertissement, informations, audit de réussite ou audit d’échec.

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 de l’événement avant d’écrire la première entrée avec la source.

Create la nouvelle source d’événement lors de l’installation de votre application. Cela laisse le temps au système d’exploitation d’actualiser sa liste des sources d’événements inscrites et 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’un EventLogInstaller, ou à l’aide de la CreateEventSource méthode . Vous devez disposer des 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 ce EventLog instance n’est pas inscrite sur l’ordinateur sur lequel votre composant écrit, WriteEntry appelle CreateEventSource et inscrit la source.

Notes

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

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

Notes

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.

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 ressources de message localisable. Utilisez la WriteEvent méthode pour écrire des événements à l’aide d’un fichier de ressources de message localisé.

Si votre application écrit des entrées à l’aide d’identificateurs de ressource et de 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.

Notes

Si vous écrivez une entrée sur un ordinateur distant, la valeur du message (la chaîne de texte) peut ne pas correspondre à ce que vous attendez si l’ordinateur distant n’exécute pas le .NET Framework.

Notes

Si le message paramètre contient un caractère NUL, le message dans le journal des événements se termine au niveau du caractère NUL.

Voir aussi

S’applique à

WriteEntry(String, String, EventLogEntryType, Int32)

Source:
EventLog.cs
Source:
EventLog.cs
Source:
EventLog.cs

Écrit une entrée avec le texte de message donné et l'identificateur d'événements défini par l'application, dans le journal des événements, à l'aide de la source d'événements 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 grâce à 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 valeurs de l'objet EventLogEntryType.

eventID
Int32

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

Exceptions

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

- ou -

source a la valeur null.

- ou -

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

- ou -

La chaîne de message dépasse 31 839 octets (32 766 octets sur les systèmes d'exploitation Windows antérieurs à Windows Vista).

- ou -

Le nom de source fournit un chemin d'accès de clé de Registre dépassant 254 caractères.

La clé de Registre du journal des événements n'a pas pu être ouverte.

type n’est pas un EventLogEntryType valide.

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" ) )
{
   EventLog::CreateEventSource( "MySource", "myNewLog" );
   Console::WriteLine( "Creating EventSource" );
}

// 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(!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énements pour le journal approprié. , eventIDainsi que la source, identifient 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 ils sont mappés. Les observateurs d’événements présentent ces chaînes à l’utilisateur pour l’aider à comprendre ce qui s’est mal passé et suggérer les actions à entreprendre.

Notes

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

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

Vous devez créer et configurer la source d’événements avant d’écrire la première entrée avec la source. Create la nouvelle source d’événement pendant l’installation de votre application. Cela laisse le temps au système d’exploitation d’actualiser sa liste des sources d’événements inscrites et 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 EventLogInstaller, ou à l’aide 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 ressources de message localisable. Utilisez la WriteEvent méthode pour écrire des événements à l’aide d’un fichier de ressources de message localisé.

Si votre application écrit des entrées à l’aide d’identificateurs de ressource et de 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 méthode pour écrire des entrées à l’aide WriteEvent d’identificateurs de ressource dans le journal des événements. Créez ensuite une autre source sans fichiers de ressources, puis 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.

Notes

Si le message paramètre contient un caractère NUL, le message dans le journal des événements se termine au niveau du caractère NUL.

Voir aussi

S’applique à

WriteEntry(String, EventLogEntryType, Int32, Int16)

Source:
EventLog.cs
Source:
EventLog.cs
Source:
EventLog.cs

Écrit une entrée avec le texte de message donné, l'identificateur de l'é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 valeurs de l'objet EventLogEntryType.

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

La propriété Source de EventLog n'a pas été définie.

- ou -

La méthode a tenté d'inscrire un nouvel événement source, mais le nom d'ordinateur figurant dans MachineName n'est pas valide.

- ou -

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

- ou -

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

- ou -

La chaîne de message dépasse 31 839 octets (32 766 octets sur les systèmes d'exploitation Windows antérieurs à Windows Vista).

- ou -

Le nom de source fournit un chemin d'accès de clé de Registre dépassant 254 caractères.

La clé de Registre du journal des événements n'a pas pu être ouverte.

type n’est pas un EventLogEntryType valide.

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 = gcnew 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.
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 dans category le journal des événements. Le observateur d'événements utilise la catégorie pour filtrer les événements écrits par une source d’événement. Le 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.

Notes

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 le observateur d'événements. Par exemple, un -10 apparaît comme 65 526, un -1 comme 65 535.

Notes

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

Pour afficher des chaînes de catégorie localisées dans le observateur d'événements, vous devez utiliser une source d’événements configurée avec un fichier de ressources de catégorie et définir sur category un identificateur de ressource dans le fichier de ressources de catégorie. Si la source d’événement n’a pas de fichier de ressources de catégorie configuré ou si le spécifié n’indexe category pas de chaîne dans le fichier de ressources de catégorie, le observateur d'événements affiche la valeur de catégorie numérique de 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 EventLogInstallerEventSourceCreationData classe ou .

En plus de 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. Les identificateurs d’événement, ainsi que la source d’événement, identifient 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 ils sont mappés. Les visionneuses d’événements affichent ces valeurs de chaîne pour aider l’utilisateur à comprendre ce qui s’est mal passé et suggérer les actions à entreprendre.

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

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énements avant d’écrire la première entrée avec la source.

Create la nouvelle source d’événement pendant l’installation de votre application. Cela laisse le temps au système d’exploitation d’actualiser sa liste des sources d’événements inscrites et 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 EventLogInstaller, ou à l’aide 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 sur lequel votre composant écrit, WriteEntry appelle CreateEventSource et inscrit la source.

Notes

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

Si le système doit inscrire le Source via un appel à WriteEntry et que la Log propriété n’a pas été définie sur votre EventLog instance, le journal est défini par défaut sur le journal de l’application.

Notes

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 de .Source

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 ressources de message localisable. Utilisez la WriteEvent méthode pour écrire des événements à l’aide d’un fichier de ressources de message localisé.

Si votre application écrit des entrées à l’aide d’identificateurs de ressource et de 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 méthode pour écrire des entrées à l’aide WriteEvent d’identificateurs de ressource dans le journal des événements. Créez ensuite une autre source sans fichiers de ressources, puis 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.

Notes

Si vous écrivez une entrée sur un ordinateur distant, la valeur du message (la chaîne de texte) peut ne pas correspondre à ce que vous attendez si l’ordinateur distant n’exécute pas .NET Framework.

Notes

Si le message paramètre contient un caractère NUL, le message dans le journal des événements se termine au niveau du caractère NUL.

Voir aussi

S’applique à

WriteEntry(String, EventLogEntryType)

Source:
EventLog.cs
Source:
EventLog.cs
Source:
EventLog.cs

É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.

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 valeurs de l'objet EventLogEntryType.

Exceptions

La propriété Source de EventLog n'a pas été définie.

- ou -

La méthode a tenté d'inscrire un nouvel événement source, mais le nom d'ordinateur figurant dans MachineName n'est pas valide.

- ou -

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

- ou -

La chaîne de message dépasse 31 839 octets (32 766 octets sur les systèmes d'exploitation Windows antérieurs à Windows Vista).

- ou -

Le nom de source fournit un chemin d'accès de clé de Registre dépassant 254 caractères.

type n’est pas un EventLogEntryType valide.

La clé de Registre du journal des événements n'a pas pu être ouverte.

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.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int main()
{
   
   // Create an EventLog instance and assign its source.
   EventLog^ myLog = gcnew EventLog("MyNewLog");
   myLog->Source = "MyNewLogSource";
   
   // Write an informational entry to the event log.    
   myLog->WriteEntry( "Writing warning to event log.", EventLogEntryType::Warning );
}
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. le type est indiqué par une icône et un texte dans la colonne Type dans le observateur d'événements d’un journal.

Notes

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

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énements avant d’écrire la première entrée avec la source.

Create la nouvelle source d’événement pendant l’installation de votre application. Cela laisse le temps au système d’exploitation d’actualiser sa liste des sources d’événements inscrites et 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 EventLogInstaller, ou à l’aide 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 sur lequel votre composant écrit, WriteEntry appelle CreateEventSource et inscrit la source.

Notes

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

Si le système doit inscrire le Source via un appel à WriteEntry et que la Log propriété n’a pas été définie sur votre EventLog instance, le journal est défini par défaut sur le journal de l’application.

Notes

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 de .Source

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 ressources de message localisable. Utilisez la WriteEvent méthode pour écrire des événements à l’aide d’un fichier de ressources de message localisé.

Si votre application écrit des entrées à l’aide d’identificateurs de ressource et de 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 méthode pour écrire des entrées à l’aide WriteEvent d’identificateurs de ressource dans le journal des événements. Créez ensuite une autre source sans fichiers de ressources, puis 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.

Notes

Si vous écrivez une entrée sur un ordinateur distant, la valeur du message (la chaîne de texte) peut ne pas correspondre à ce que vous attendez si l’ordinateur distant n’exécute pas .NET Framework.

Notes

Si le message paramètre contient un caractère NUL, le message dans le journal des événements se termine au niveau du caractère NUL.

Voir aussi

S’applique à

WriteEntry(String, EventLogEntryType, Int32)

Source:
EventLog.cs
Source:
EventLog.cs
Source:
EventLog.cs

Écrit une entrée avec le texte de message donné et l'identificateur d'événements 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 valeurs de l'objet EventLogEntryType.

eventID
Int32

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

Exceptions

La propriété Source de EventLog n'a pas été définie.

- ou -

La méthode a tenté d'inscrire un nouvel événement source, mais le nom d'ordinateur figurant dans MachineName n'est pas valide.

- ou -

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

- ou -

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

- ou -

La chaîne de message dépasse 31 839 octets (32 766 octets sur les systèmes d'exploitation Windows antérieurs à Windows Vista).

- ou -

Le nom de source fournit un chemin d'accès de clé de Registre dépassant 254 caractères.

La clé de Registre du journal des événements n'a pas pu être ouverte.

type n’est pas un EventLogEntryType valide.

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 = gcnew 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.
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 dans eventID le journal des événements. avec eventID 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 ils sont mappés. Les visionneuses d’événements affichent ces valeurs de chaîne pour aider l’utilisateur à comprendre ce qui s’est mal passé et suggérer les actions à entreprendre.

Notes

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

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

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énements avant d’écrire la première entrée avec la source.

Create la nouvelle source d’événement pendant l’installation de votre application. Cela laisse le temps au système d’exploitation d’actualiser sa liste des sources d’événements inscrites et 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 EventLogInstaller, ou à l’aide 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 sur lequel votre composant écrit, WriteEntry appelle CreateEventSource et inscrit la source.

Notes

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

Si le système doit inscrire le Source via un appel à WriteEntry et que la Log propriété n’a pas été définie sur votre EventLog instance, le journal est défini par défaut sur le journal de l’application.

Notes

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 de .Source

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 ressources de message localisable. Utilisez la WriteEvent méthode pour écrire des événements à l’aide d’un fichier de ressources de message localisé.

Si votre application écrit des entrées à l’aide d’identificateurs de ressource et de 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 méthode pour écrire des entrées à l’aide WriteEvent d’identificateurs de ressource dans le journal des événements. Créez ensuite une autre source sans fichiers de ressources, puis 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.

Notes

Si vous écrivez une entrée sur un ordinateur distant, la valeur du message (la chaîne de texte) peut ne pas correspondre à ce que vous attendez si l’ordinateur distant n’exécute pas .NET Framework.

Notes

Si le message paramètre contient un caractère NUL, le message dans le journal des événements se termine au niveau du caractère NUL.

Voir aussi

S’applique à

WriteEntry(String, String)

Source:
EventLog.cs
Source:
EventLog.cs
Source:
EventLog.cs

Écrit une entrée de type information, avec le texte de message donné, dans le journal des événements, à l'aide de la source d'événements 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 grâce à laquelle l'application est inscrite sur l'ordinateur spécifié.

message
String

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

Exceptions

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

- ou -

source a la valeur null.

- ou -

La chaîne de message dépasse 31 839 octets (32 766 octets sur les systèmes d'exploitation Windows antérieurs à Windows Vista).

- ou -

Le nom de source fournit un chemin d'accès de clé de Registre dépassant 254 caractères.

La clé de Registre du journal des événements n'a pas pu être ouverte.

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 si elle n’existe pas déjà et écrit une entrée dans le journal MyNewLogdes événements .

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int main()
{
   
   // Create the source, if it does not already exist.
   if (  !EventLog::SourceExists( "MySource" ) )
   {
      EventLog::CreateEventSource( "MySource", "myNewLog" );
      Console::WriteLine( "CreatingEventSource" );
   }

   
   // Write an informational entry to the event log.    
   EventLog::WriteEntry( "MySource", "Writing to event log." );
}
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énements pour le journal approprié. Si vous souhaitez spécifier un autre EventLogEntryType, utilisez une surcharge différente de WriteEntry.

Vous devez créer et configurer la source d’événements avant d’écrire la première entrée avec la source. Create la nouvelle source d’événement pendant l’installation de votre application. Cela laisse le temps au système d’exploitation d’actualiser sa liste des sources d’événements inscrites et 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 EventLogInstaller, ou à l’aide 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 ressources de message localisable. Utilisez la WriteEvent méthode pour écrire des événements à l’aide d’un fichier de ressources de message localisé.

Si votre application écrit des entrées à l’aide d’identificateurs de ressource et de 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 méthode pour écrire des entrées à l’aide WriteEvent d’identificateurs de ressource dans le journal des événements. Créez ensuite une autre source sans fichiers de ressources, puis 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.

Notes

Si le message paramètre contient un caractère NUL, le message dans le journal des événements se termine 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 l’observateur d’événements la traite comme une chaîne d’insertion. Étant donné qu’une adresse IPv6 (Internet Protocol, version 6) peut contenir cette séquence de caractères, vous ne pouvez pas enregistrer un message d’événement qui contient une adresse IPv6.

Voir aussi

S’applique à

WriteEntry(String)

Source:
EventLog.cs
Source:
EventLog.cs
Source:
EventLog.cs

Écrit une entrée de type information, avec le texte de 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

La propriété Source de EventLog n'a pas été définie.

- ou -

La méthode a tenté d'inscrire un nouvel événement source, mais le nom d'ordinateur figurant dans MachineName n'est pas valide.

- ou -

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

- ou -

La chaîne de message dépasse 31 839 octets (32 766 octets sur les systèmes d'exploitation Windows antérieurs à Windows Vista).

- ou -

Le nom de source fournit un chemin d'accès de clé de Registre dépassant 254 caractères.

La clé de Registre du journal des événements n'a pas pu être ouverte.

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 si elle n’existe pas déjà et écrit une entrée dans le journal MyNewLogdes événements .

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int 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" );
      // The source is created.  Exit the application to allow it to be registered.
      return 0;
   }

   
   // Create an EventLog instance and assign its source.
   EventLog^ myLog = gcnew EventLog;
   myLog->Source = "MySource";
   
   // Write an informational entry to the event log.    
   myLog->WriteEntry( "Writing to event log." );
}
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.

Notes

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

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énements avant d’écrire la première entrée avec la source.

Create la nouvelle source d’événement pendant l’installation de votre application. Cela laisse le temps au système d’exploitation d’actualiser sa liste des sources d’événements inscrites et 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 EventLogInstaller, ou à l’aide 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 sur lequel votre composant écrit, WriteEntry appelle CreateEventSource et inscrit la source.

Notes

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

Si le système doit inscrire le Source via un appel à WriteEntry et que la Log propriété n’a pas été définie sur votre EventLog instance, le journal est défini par défaut sur le journal de l’application.

Notes

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 de .Source

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 ressources de message localisable. Utilisez la WriteEvent méthode pour écrire des événements à l’aide d’un fichier de ressources de message localisé.

Si votre application écrit des entrées à l’aide d’identificateurs de ressource et de 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 méthode pour écrire des entrées à l’aide WriteEvent d’identificateurs de ressource dans le journal des événements. Créez ensuite une autre source sans fichiers de ressources, puis 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.

Notes

Si vous écrivez une entrée sur un ordinateur distant, la valeur du message (la chaîne de texte) peut ne pas correspondre à ce que vous attendez si l’ordinateur distant n’exécute pas .NET Framework.

Notes

Si le message paramètre contient un caractère NUL, le message dans le journal des événements se termine au niveau du caractère NUL.

Voir aussi

S’applique à

WriteEntry(String, String, EventLogEntryType)

Source:
EventLog.cs
Source:
EventLog.cs
Source:
EventLog.cs

É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, à l'aide de la source d'événements 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 grâce à 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 valeurs de l'objet EventLogEntryType.

Exceptions

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

- ou -

source a la valeur null.

- ou -

La chaîne de message dépasse 31 839 octets (32 766 octets sur les systèmes d'exploitation Windows antérieurs à Windows Vista).

- ou -

Le nom de source fournit un chemin d'accès de clé de Registre dépassant 254 caractères.

La clé de Registre du journal des événements n'a pas pu être ouverte.

type n’est pas un EventLogEntryType valide.

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.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int main()
{
   
   // Write an informational entry to the event log.    
   EventLog::WriteEntry( "MySource", "Writing warning to event log.", EventLogEntryType::Warning );
}
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 spécifié EventLogEntryType dans le journal des événements, à l’aide d’une source déjà inscrite en tant que source d’événements pour le journal approprié. le type est indiqué par une icône et un texte dans la colonne Type dans le observateur d'événements d’un journal.

Notes

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

Vous devez créer et configurer la source de l’événement avant d’écrire la première entrée avec la source. Create la nouvelle source d’événement lors de l’installation de votre application. Cela laisse le temps au système d’exploitation d’actualiser sa liste des sources d’événements inscrites et 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’un EventLogInstaller, ou à l’aide de la CreateEventSource méthode . Vous devez disposer des 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 ressources de message localisable. Utilisez la WriteEvent méthode pour écrire des événements à l’aide d’un fichier de ressources de message localisé.

Si votre application écrit des entrées à l’aide d’identificateurs de ressource et de 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.

Notes

Si le message paramètre contient un caractère NUL, le message dans le journal des événements se termine au niveau du caractère NUL.

Voir aussi

S’applique à