EventLog.WriteEntry Methode

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())

Parameters

Uitzonderingen

Voorbeelden

//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)

Opmerkingen

Gebruik deze methode om toepassingsspecifieke gebeurtenisspecifieke gegevens naar het gebeurtenislogboek te schrijven met behulp van een bron die al is geregistreerd als gebeurtenisbron voor het juiste logboek. De Logboeken interpreteert deze gegevens niet; onbewerkte gegevens worden alleen weergegeven in een gecombineerde hexadecimale en tekstindeling. Gebeurtenisspecifieke gegevens spaarzaam gebruiken; neem deze alleen op als u zeker weet dat het nuttig is. U kunt ook gebeurtenisspecifieke gegevens gebruiken om informatie op te slaan die de toepassing onafhankelijk van de Logboeken kan verwerken. U kunt bijvoorbeeld een viewer specifiek schrijven voor uw gebeurtenissen of een programma schrijven waarmee het logboekbestand wordt gescand en rapporten worden gemaakt die informatie bevatten van de gebeurtenisspecifieke gegevens.

Naast de binaire gegevens kunt u een toepassingsgedefinieerde categorie en een toepassingsgedefinieerde gebeurtenis-id opgeven. De Logboeken gebruikt de categorie om gebeurtenissen te filteren die zijn geschreven door een gebeurtenisbron. De Logboeken kan de categorie weergeven als een numerieke waarde of kan de categorie als resource-id gebruiken om een gelokaliseerde categorietekenreeks weer te geven.

Als u gelokaliseerde categorietekenreeksen wilt weergeven in de Logboeken, moet u een gebeurtenisbron gebruiken die is geconfigureerd met een categorieresourcebestand en de category instellen op een resource-id in het categorieresourcebestand. Als de gebeurtenisbron geen geconfigureerd categorieresourcebestand heeft of als de opgegeven category geen tekenreeks indexeren in het resourcebestand van de categorie, geeft de Logboeken de numerieke categoriewaarde voor die vermelding weer. Configureer het categorieresourcebestand, samen met het aantal categorietekenreeksen in het resourcebestand, met behulp van de EventLogInstaller of de EventSourceCreationData klasse.

Gebeurtenis-id's, samen met de gebeurtenisbron, identificeren een gebeurtenis op unieke wijze. Elke toepassing kan zijn eigen genummerde gebeurtenissen en de beschrijvingstekenreeksen definiëren waaraan ze worden toegewezen. Gebeurtenisviewers geven deze tekenreekswaarden weer om de gebruiker te helpen begrijpen wat er fout is gegaan en om aan te geven welke acties moeten worden ondernomen.

Ten slotte kunt u een EventLogEntryType opgeven voor de gebeurtenis die naar het gebeurtenislogboek wordt geschreven. De type wordt aangegeven door een pictogram en tekst in de kolom Type in de Logboeken voor een logboek. Met deze parameter wordt aangegeven of het gebeurtenistype fout, waarschuwing, informatie, geslaagde controle of controle van fouten is.

U moet de gebeurtenisbron maken en configureren voordat u de eerste vermelding met de bron schrijft. Maak de nieuwe gebeurtenisbron tijdens de installatie van uw toepassing. Hierdoor kan het besturingssysteem de lijst met geregistreerde gebeurtenisbronnen en hun configuratie vernieuwen. Als het besturingssysteem de lijst met gebeurtenisbronnen niet heeft vernieuwd en u probeert een gebeurtenis te schrijven met de nieuwe bron, mislukt de schrijfbewerking. U kunt een nieuwe bron configureren met behulp van een EventLogInstallerof met behulp van de CreateEventSource methode. U moet beheerdersrechten hebben op de computer om een nieuwe gebeurtenisbron te maken.

De bron moet worden geconfigureerd voor het schrijven van gelokaliseerde vermeldingen of voor het schrijven van directe tekenreeksen. De WriteEntry methode schrijft de opgegeven tekenreeks rechtstreeks naar het gebeurtenislogboek. Er wordt geen lokaal berichtbronbestand gebruikt. Gebruik de WriteEvent methode om gebeurtenissen te schrijven met behulp van een gelokaliseerd berichtbronbestand.

Als uw toepassing vermeldingen schrijft met zowel resource-id's als tekenreekswaarden, moet u twee afzonderlijke bronnen registreren. Configureer bijvoorbeeld één bron met resourcebestanden en gebruik die bron in de WriteEvent methode om vermeldingen te schrijven met behulp van resource-id's naar het gebeurtenislogboek. Maak vervolgens een andere bron zonder resourcebestanden en gebruik die bron in de WriteEntry methode om tekenreeksen rechtstreeks naar het gebeurtenislogboek te schrijven met behulp van die bron.

Zie ook

• EventLogEntryType
• Source
• CreateEventSource
• DeleteEventSource(String)
• SourceExists(String)
• Entries

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)

Parameters

Uitzonderingen

Voorbeelden

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)

Opmerkingen

Gebruik deze methode om een vermelding te schrijven met een toepassing die is gedefinieerd category in het gebeurtenislogboek, met behulp van een bron die al is geregistreerd als gebeurtenisbron voor het juiste logboek. De Logboeken gebruikt de categorie om gebeurtenissen te filteren die zijn geschreven door een gebeurtenisbron. De Logboeken kan de categorie weergeven als een numerieke waarde of kan de categorie als resource-id gebruiken om een gelokaliseerde categorietekenreeks weer te geven.

Als u gelokaliseerde categorietekenreeksen wilt weergeven in de Logboeken, moet u een gebeurtenisbron gebruiken die is geconfigureerd met een categorieresourcebestand en de category instellen op een resource-id in het categorieresourcebestand. Als de gebeurtenisbron geen geconfigureerd categorieresourcebestand heeft of als de opgegeven category geen tekenreeks indexeren in het resourcebestand van de categorie, geeft de Logboeken de numerieke categoriewaarde voor die vermelding weer. Configureer het categorieresourcebestand, samen met het aantal categorietekenreeksen in het resourcebestand, met behulp van de EventLogInstaller of de EventSourceCreationData klasse.

Naast de categorie kunt u een gebeurtenis-id opgeven voor de gebeurtenis die naar het gebeurtenislogboek wordt geschreven. Gebeurtenis-id's, samen met de gebeurtenisbron, identificeren een gebeurtenis op unieke wijze. Elke toepassing kan zijn eigen genummerde gebeurtenissen en de beschrijvingstekenreeksen definiëren waaraan ze worden toegewezen. Gebeurtenisviewers geven deze tekenreekswaarden weer om de gebruiker te helpen begrijpen wat er fout is gegaan en om aan te geven welke acties moeten worden ondernomen.

Ten slotte kunt u een EventLogEntryType opgeven voor de gebeurtenis die naar het gebeurtenislogboek wordt geschreven. De type wordt aangegeven door een pictogram en tekst in de kolom Type in de Logboeken voor een logboek. Met deze parameter wordt aangegeven of het gebeurtenistype fout, waarschuwing, informatie, geslaagde controle of controle van fouten is.

U moet de gebeurtenisbron maken en configureren voordat u de eerste vermelding met de bron schrijft. Maak de nieuwe gebeurtenisbron tijdens de installatie van uw toepassing. Hierdoor kan het besturingssysteem de lijst met geregistreerde gebeurtenisbronnen en hun configuratie vernieuwen. Als het besturingssysteem de lijst met gebeurtenisbronnen niet heeft vernieuwd en u probeert een gebeurtenis te schrijven met de nieuwe bron, mislukt de schrijfbewerking. U kunt een nieuwe bron configureren met behulp van een EventLogInstallerof met behulp van de CreateEventSource methode. U moet beheerdersrechten hebben op de computer om een nieuwe gebeurtenisbron te maken.

De bron moet worden geconfigureerd voor het schrijven van gelokaliseerde vermeldingen of voor het schrijven van directe tekenreeksen. De WriteEntry methode schrijft de opgegeven tekenreeks rechtstreeks naar het gebeurtenislogboek. Er wordt geen lokaal berichtbronbestand gebruikt. Gebruik de WriteEvent methode om gebeurtenissen te schrijven met behulp van een gelokaliseerd berichtbronbestand.

Als uw toepassing vermeldingen schrijft met zowel resource-id's als tekenreekswaarden, moet u twee afzonderlijke bronnen registreren. Configureer bijvoorbeeld één bron met resourcebestanden en gebruik die bron in de WriteEvent methode om vermeldingen te schrijven met behulp van resource-id's naar het gebeurtenislogboek. Maak vervolgens een andere bron zonder resourcebestanden en gebruik die bron in de WriteEntry methode om tekenreeksen rechtstreeks naar het gebeurtenislogboek te schrijven met behulp van die bron.

Zie ook

• EventLogEntryType
• Source
• CreateEventSource
• DeleteEventSource(String)
• SourceExists(String)
• Entries

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())

Parameters

Uitzonderingen

Voorbeelden

// 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)

Opmerkingen

Gebruik deze overbelasting om toepassingsspecifieke gebeurtenisspecifieke gegevens naar het gebeurtenislogboek te schrijven. De Logboeken interpreteert deze gegevens niet; onbewerkte gegevens worden alleen weergegeven in een gecombineerde hexadecimale en tekstindeling. Gebruik gebeurtenisspecifieke gegevens spaarzaam, inclusief alleen als u zeker weet dat deze nuttig zijn voor iemand die het probleem opspoort. U kunt ook gebeurtenisspecifieke gegevens gebruiken om informatie op te slaan die de toepassing onafhankelijk van de Logboeken kan verwerken. U kunt bijvoorbeeld een viewer specifiek schrijven voor uw gebeurtenissen of een programma schrijven waarmee het logboekbestand wordt gescand en rapporten worden gemaakt die informatie bevatten van de gebeurtenisspecifieke gegevens.

Naast de binaire gegevens kunt u een toepassingsgedefinieerde categorie en een toepassingsgedefinieerde gebeurtenis-id opgeven. De Logboeken gebruikt de categorie om gebeurtenissen te filteren die zijn geschreven door een gebeurtenisbron. De Logboeken kan de categorie weergeven als een numerieke waarde of kan de categorie als resource-id gebruiken om een gelokaliseerde categorietekenreeks weer te geven.

Als u gelokaliseerde categorietekenreeksen wilt weergeven in de Logboeken, moet u een gebeurtenisbron gebruiken die is geconfigureerd met een categorieresourcebestand en de category instellen op een resource-id in het categorieresourcebestand. Als de gebeurtenisbron geen geconfigureerd categorieresourcebestand heeft of als de opgegeven category geen tekenreeks indexeren in het resourcebestand van de categorie, geeft de Logboeken de numerieke categoriewaarde voor die vermelding weer. Configureer het categorieresourcebestand, samen met het aantal categorietekenreeksen in het resourcebestand, met behulp van de EventLogInstaller of de EventSourceCreationData klasse.

Gebeurtenis-id's, samen met de gebeurtenisbron, identificeren een gebeurtenis op unieke wijze. Elke toepassing kan zijn eigen genummerde gebeurtenissen en de beschrijvingstekenreeksen definiëren waaraan ze worden toegewezen. Gebeurtenisviewers geven deze tekenreekswaarden weer om de gebruiker te helpen begrijpen wat er fout is gegaan en om aan te geven welke acties moeten worden ondernomen.

Ten slotte kunt u een EventLogEntryType opgeven voor de gebeurtenis die naar het gebeurtenislogboek wordt geschreven. De type wordt aangegeven door een pictogram en tekst in de kolom Type in de Logboeken voor een logboek. Met deze parameter wordt aangegeven of het gebeurtenistype fout, waarschuwing, informatie, geslaagde controle of controle van fouten is.

U moet de Source eigenschap voor uw EventLog onderdeel instellen voordat u vermeldingen naar het logboek kunt schrijven. U moet de gebeurtenisbron maken en configureren voordat u de eerste vermelding met de bron schrijft.

Maak de nieuwe gebeurtenisbron tijdens de installatie van uw toepassing. Hierdoor kan het besturingssysteem de lijst met geregistreerde gebeurtenisbronnen en hun configuratie vernieuwen. Als het besturingssysteem de lijst met gebeurtenisbronnen niet heeft vernieuwd en u probeert een gebeurtenis te schrijven met de nieuwe bron, mislukt de schrijfbewerking. U kunt een nieuwe bron configureren met behulp van een EventLogInstallerof met behulp van de CreateEventSource methode. U moet beheerdersrechten hebben op de computer om een nieuwe gebeurtenisbron te maken.

Als de bron die is opgegeven in de Source eigenschap van dit EventLog exemplaar niet is geregistreerd op de computer waarnaar uw onderdeel schrijft, WriteEntry roept CreateEventSource u de bron aan en registreert u deze.

Als het systeem de Source door een aanroep WriteEntry moet registreren en de Log eigenschap niet is ingesteld op uw EventLog exemplaar, wordt het logboek standaard ingesteld op het toepassingslogboek.

De bron moet worden geconfigureerd voor het schrijven van gelokaliseerde vermeldingen of voor het schrijven van directe tekenreeksen. De WriteEntry methode schrijft de opgegeven tekenreeks rechtstreeks naar het gebeurtenislogboek. Er wordt geen lokaal berichtbronbestand gebruikt. Gebruik de WriteEvent methode om gebeurtenissen te schrijven met behulp van een gelokaliseerd berichtbronbestand.

Als uw toepassing vermeldingen schrijft met zowel resource-id's als tekenreekswaarden, moet u twee afzonderlijke bronnen registreren. Configureer bijvoorbeeld één bron met resourcebestanden en gebruik die bron in de WriteEvent methode om vermeldingen te schrijven met behulp van resource-id's naar het gebeurtenislogboek. Maak vervolgens een andere bron zonder resourcebestanden en gebruik die bron in de WriteEntry methode om tekenreeksen rechtstreeks naar het gebeurtenislogboek te schrijven met behulp van die bron.

Zie ook

• EventLogEntryType
• Source
• CreateEventSource
• DeleteEventSource(String)
• SourceExists(String)
• Entries

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)

Parameters

Uitzonderingen

Voorbeelden

// 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)

Opmerkingen

Gebruik deze methode om een vermelding te schrijven met een toepassing die is gedefinieerd eventID in het gebeurtenislogboek, met behulp van een bron die al is geregistreerd als gebeurtenisbron voor het juiste logboek. De eventID, samen met de bron, identificeert een gebeurtenis op unieke wijze. Elke toepassing kan zijn eigen genummerde gebeurtenissen en de beschrijvingstekenreeksen definiëren waaraan ze worden toegewezen. Gebeurtenisviewers presenteren deze tekenreeksen aan de gebruiker om de gebruiker te helpen begrijpen wat er mis is gegaan en voorstellen welke acties moeten worden ondernomen.

Naast de gebeurtenis-id kunt u met deze overbelasting WriteEntry een EventLogEntryType gebeurtenis opgeven die naar het gebeurtenislogboek wordt geschreven. De type wordt aangegeven door een pictogram en tekst in de kolom Type in de Logboeken voor een logboek. Met deze parameter wordt aangegeven of het gebeurtenistype fout, waarschuwing, informatie, geslaagde controle of controle van fouten is.

U moet de gebeurtenisbron maken en configureren voordat u de eerste vermelding met de bron schrijft. Maak de nieuwe gebeurtenisbron tijdens de installatie van uw toepassing. Hierdoor kan het besturingssysteem de lijst met geregistreerde gebeurtenisbronnen en hun configuratie vernieuwen. Als het besturingssysteem de lijst met gebeurtenisbronnen niet heeft vernieuwd en u probeert een gebeurtenis te schrijven met de nieuwe bron, mislukt de schrijfbewerking. U kunt een nieuwe bron configureren met behulp van een EventLogInstallerof met behulp van de CreateEventSource methode. U moet beheerdersrechten hebben op de computer om een nieuwe gebeurtenisbron te maken.

De bron moet worden geconfigureerd voor het schrijven van gelokaliseerde vermeldingen of voor het schrijven van directe tekenreeksen. De WriteEntry methode schrijft de opgegeven tekenreeks rechtstreeks naar het gebeurtenislogboek. Er wordt geen lokaal berichtbronbestand gebruikt. Gebruik de WriteEvent methode om gebeurtenissen te schrijven met behulp van een gelokaliseerd berichtbronbestand.

Als uw toepassing vermeldingen schrijft met zowel resource-id's als tekenreekswaarden, moet u twee afzonderlijke bronnen registreren. Configureer bijvoorbeeld één bron met resourcebestanden en gebruik die bron in de WriteEvent methode om vermeldingen te schrijven met behulp van resource-id's naar het gebeurtenislogboek. Maak vervolgens een andere bron zonder resourcebestanden en gebruik die bron in de WriteEntry methode om tekenreeksen rechtstreeks naar het gebeurtenislogboek te schrijven met behulp van die bron.

Zie ook

• EventLogEntryType
• Source
• CreateEventSource
• DeleteEventSource(String)
• SourceExists(String)
• Entries

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)

Parameters

Uitzonderingen

Voorbeelden

// 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)

Opmerkingen

Gebruik deze methode om een vermelding te schrijven met een toepassing die is gedefinieerd category in het gebeurtenislogboek. De Logboeken gebruikt de categorie om gebeurtenissen te filteren die zijn geschreven door een gebeurtenisbron. De Logboeken kan de categorie weergeven als een numerieke waarde of kan de categorie als resource-id gebruiken om een gelokaliseerde categorietekenreeks weer te geven.

Als u gelokaliseerde categorietekenreeksen wilt weergeven in de Logboeken, moet u een gebeurtenisbron gebruiken die is geconfigureerd met een categorieresourcebestand en de category instellen op een resource-id in het categorieresourcebestand. Als de gebeurtenisbron geen geconfigureerd categorieresourcebestand heeft of als de opgegeven category geen tekenreeks indexeren in het resourcebestand van de categorie, geeft de Logboeken de numerieke categoriewaarde voor die vermelding weer. Configureer het categorieresourcebestand, samen met het aantal categorietekenreeksen in het resourcebestand, met behulp van de EventLogInstaller of de EventSourceCreationData klasse.

Naast de categorie kunt u een gebeurtenis-id opgeven voor de gebeurtenis die naar het gebeurtenislogboek wordt geschreven. Gebeurtenis-id's, samen met de gebeurtenisbron, identificeren een gebeurtenis op unieke wijze. Elke toepassing kan zijn eigen genummerde gebeurtenissen en de beschrijvingstekenreeksen definiëren waaraan ze worden toegewezen. Gebeurtenisviewers geven deze tekenreekswaarden weer om de gebruiker te helpen begrijpen wat er fout is gegaan en om aan te geven welke acties moeten worden ondernomen.

Ten slotte kunt u een EventLogEntryType opgeven voor de gebeurtenis die naar het gebeurtenislogboek wordt geschreven. De type wordt aangegeven door een pictogram en tekst in de kolom Type in de Logboeken voor een logboek. Met deze parameter wordt aangegeven of het gebeurtenistype fout, waarschuwing, informatie, geslaagde controle of controle van fouten is.

U moet de Source eigenschap voor uw EventLog onderdeel instellen voordat u vermeldingen naar het logboek kunt schrijven. U moet de gebeurtenisbron maken en configureren voordat u de eerste vermelding met de bron schrijft.

Maak de nieuwe gebeurtenisbron tijdens de installatie van uw toepassing. Hierdoor kan het besturingssysteem de lijst met geregistreerde gebeurtenisbronnen en hun configuratie vernieuwen. Als het besturingssysteem de lijst met gebeurtenisbronnen niet heeft vernieuwd en u probeert een gebeurtenis te schrijven met de nieuwe bron, mislukt de schrijfbewerking. U kunt een nieuwe bron configureren met behulp van een EventLogInstallerof met behulp van de CreateEventSource methode. U moet beheerdersrechten hebben op de computer om een nieuwe gebeurtenisbron te maken.

Als de bron die is opgegeven in de Source eigenschap van dit EventLog exemplaar niet is geregistreerd op de computer waarnaar uw onderdeel schrijft, WriteEntry roept CreateEventSource u de bron aan en registreert u deze.

Als het systeem de Source door een aanroep WriteEntry moet registreren en de Log eigenschap niet is ingesteld op uw EventLog exemplaar, wordt het logboek standaard ingesteld op het toepassingslogboek.

De bron moet worden geconfigureerd voor het schrijven van gelokaliseerde vermeldingen of voor het schrijven van directe tekenreeksen. De WriteEntry methode schrijft de opgegeven tekenreeks rechtstreeks naar het gebeurtenislogboek. Er wordt geen lokaal berichtbronbestand gebruikt. Gebruik de WriteEvent methode om gebeurtenissen te schrijven met behulp van een gelokaliseerd berichtbronbestand.

Als uw toepassing vermeldingen schrijft met zowel resource-id's als tekenreekswaarden, moet u twee afzonderlijke bronnen registreren. Configureer bijvoorbeeld één bron met resourcebestanden en gebruik die bron in de WriteEvent methode om vermeldingen te schrijven met behulp van resource-id's naar het gebeurtenislogboek. Maak vervolgens een andere bron zonder resourcebestanden en gebruik die bron in de WriteEntry methode om tekenreeksen rechtstreeks naar het gebeurtenislogboek te schrijven met behulp van die bron.

Zie ook

• EventLogEntryType
• Source
• CreateEventSource
• DeleteEventSource(String)
• SourceExists(String)
• Entries

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)

Parameters

Uitzonderingen

Voorbeelden

In het volgende voorbeeld wordt een waarschuwingsvermelding naar een gebeurtenislogboek geschreven, 'MyNewLog', op de lokale computer.

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

Opmerkingen

Gebruik deze methode om een vermelding van een opgegeven EventLogEntryType item naar het gebeurtenislogboek te schrijven. De type wordt aangegeven door een pictogram en tekst in de kolom Type in de Logboeken voor een logboek.

U moet de Source eigenschap voor uw EventLog onderdeel instellen voordat u vermeldingen naar het logboek kunt schrijven. U moet de gebeurtenisbron maken en configureren voordat u de eerste vermelding met de bron schrijft.

Maak de nieuwe gebeurtenisbron tijdens de installatie van uw toepassing. Hierdoor kan het besturingssysteem de lijst met geregistreerde gebeurtenisbronnen en hun configuratie vernieuwen. Als het besturingssysteem de lijst met gebeurtenisbronnen niet heeft vernieuwd en u probeert een gebeurtenis te schrijven met de nieuwe bron, mislukt de schrijfbewerking. U kunt een nieuwe bron configureren met behulp van een EventLogInstallerof met behulp van de CreateEventSource methode. U moet beheerdersrechten hebben op de computer om een nieuwe gebeurtenisbron te maken.

Als de bron die is opgegeven in de Source eigenschap van dit EventLog exemplaar niet is geregistreerd op de computer waarnaar uw onderdeel schrijft, WriteEntry roept CreateEventSource u de bron aan en registreert u deze.

Als het systeem de Source door een aanroep WriteEntry moet registreren en de Log eigenschap niet is ingesteld op uw EventLog exemplaar, wordt het logboek standaard ingesteld op het toepassingslogboek.

De bron moet worden geconfigureerd voor het schrijven van gelokaliseerde vermeldingen of voor het schrijven van directe tekenreeksen. De WriteEntry methode schrijft de opgegeven tekenreeks rechtstreeks naar het gebeurtenislogboek. Er wordt geen lokaal berichtbronbestand gebruikt. Gebruik de WriteEvent methode om gebeurtenissen te schrijven met behulp van een gelokaliseerd berichtbronbestand.

Als uw toepassing vermeldingen schrijft met zowel resource-id's als tekenreekswaarden, moet u twee afzonderlijke bronnen registreren. Configureer bijvoorbeeld één bron met resourcebestanden en gebruik die bron in de WriteEvent methode om vermeldingen te schrijven met behulp van resource-id's naar het gebeurtenislogboek. Maak vervolgens een andere bron zonder resourcebestanden en gebruik die bron in de WriteEntry methode om tekenreeksen rechtstreeks naar het gebeurtenislogboek te schrijven met behulp van die bron.

Zie ook

• EventLogEntryType
• Source
• CreateEventSource
• DeleteEventSource(String)
• SourceExists(String)
• Entries

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)

Parameters

Uitzonderingen

Voorbeelden

// 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)

Opmerkingen

Gebruik deze methode om een vermelding te schrijven met een toepassing die is gedefinieerd eventID in het gebeurtenislogboek. De eventID samen met de bron identificeert een gebeurtenis op unieke wijze. Elke toepassing kan zijn eigen genummerde gebeurtenissen en de beschrijvingstekenreeksen definiëren waaraan ze worden toegewezen. Gebeurtenisviewers geven deze tekenreekswaarden weer om de gebruiker te helpen begrijpen wat er fout is gegaan en om aan te geven welke acties moeten worden ondernomen.

Naast de gebeurtenis-id kunt u een EventLogEntryType voor de gebeurtenis opgeven die naar het gebeurtenislogboek wordt geschreven. De type wordt aangegeven door een pictogram en tekst in de kolom Type in de Logboeken voor een logboek. Met deze parameter wordt aangegeven of het gebeurtenistype fout, waarschuwing, informatie, geslaagde controle of controle van fouten is.

U moet de Source eigenschap voor uw EventLog onderdeel instellen voordat u vermeldingen naar het logboek kunt schrijven. U moet de gebeurtenisbron maken en configureren voordat u de eerste vermelding met de bron schrijft.

Maak de nieuwe gebeurtenisbron tijdens de installatie van uw toepassing. Hierdoor kan het besturingssysteem de lijst met geregistreerde gebeurtenisbronnen en hun configuratie vernieuwen. Als het besturingssysteem de lijst met gebeurtenisbronnen niet heeft vernieuwd en u probeert een gebeurtenis te schrijven met de nieuwe bron, mislukt de schrijfbewerking. U kunt een nieuwe bron configureren met behulp van een EventLogInstallerof met behulp van de CreateEventSource methode. U moet beheerdersrechten hebben op de computer om een nieuwe gebeurtenisbron te maken.

Als de bron die is opgegeven in de Source eigenschap van dit EventLog exemplaar niet is geregistreerd op de computer waarnaar uw onderdeel schrijft, WriteEntry roept CreateEventSource u de bron aan en registreert u deze.

Als het systeem de Source door een aanroep WriteEntry moet registreren en de Log eigenschap niet is ingesteld op uw EventLog exemplaar, wordt het logboek standaard ingesteld op het toepassingslogboek.

De bron moet worden geconfigureerd voor het schrijven van gelokaliseerde vermeldingen of voor het schrijven van directe tekenreeksen. De WriteEntry methode schrijft de opgegeven tekenreeks rechtstreeks naar het gebeurtenislogboek. Er wordt geen lokaal berichtbronbestand gebruikt. Gebruik de WriteEvent methode om gebeurtenissen te schrijven met behulp van een gelokaliseerd berichtbronbestand.

Als uw toepassing vermeldingen schrijft met zowel resource-id's als tekenreekswaarden, moet u twee afzonderlijke bronnen registreren. Configureer bijvoorbeeld één bron met resourcebestanden en gebruik die bron in de WriteEvent methode om vermeldingen te schrijven met behulp van resource-id's naar het gebeurtenislogboek. Maak vervolgens een andere bron zonder resourcebestanden en gebruik die bron in de WriteEntry methode om tekenreeksen rechtstreeks naar het gebeurtenislogboek te schrijven met behulp van die bron.

Zie ook

• EventLogEntryType
• Source
• CreateEventSource
• DeleteEventSource(String)
• SourceExists(String)
• Entries

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)

Parameters

Uitzonderingen

Voorbeelden

In het volgende voorbeeld wordt de bron MySource gemaakt als deze nog niet bestaat en schrijft een vermelding naar het gebeurtenislogboek MyNewLog.

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

Opmerkingen

Gebruik deze methode om een informatievermelding naar het gebeurtenislogboek te schrijven met behulp van een bron die al is geregistreerd als gebeurtenisbron voor het juiste logboek. Als u een andere EventLogEntryTypewilt opgeven, gebruikt u een andere overbelasting van WriteEntry.

U moet de gebeurtenisbron maken en configureren voordat u de eerste vermelding met de bron schrijft. Maak de nieuwe gebeurtenisbron tijdens de installatie van uw toepassing. Hierdoor kan het besturingssysteem de lijst met geregistreerde gebeurtenisbronnen en hun configuratie vernieuwen. Als het besturingssysteem de lijst met gebeurtenisbronnen niet heeft vernieuwd en u probeert een gebeurtenis te schrijven met de nieuwe bron, mislukt de schrijfbewerking. U kunt een nieuwe bron configureren met behulp van een EventLogInstallerof met behulp van de CreateEventSource methode. U moet beheerdersrechten hebben op de computer om een nieuwe gebeurtenisbron te maken.

De bron moet worden geconfigureerd voor het schrijven van gelokaliseerde vermeldingen of voor het schrijven van directe tekenreeksen. De WriteEntry methode schrijft de opgegeven tekenreeks rechtstreeks naar het gebeurtenislogboek. Er wordt geen lokaal berichtbronbestand gebruikt. Gebruik de WriteEvent methode om gebeurtenissen te schrijven met behulp van een gelokaliseerd berichtbronbestand.

Als uw toepassing vermeldingen schrijft met zowel resource-id's als tekenreekswaarden, moet u twee afzonderlijke bronnen registreren. Configureer bijvoorbeeld één bron met resourcebestanden en gebruik die bron in de WriteEvent methode om vermeldingen te schrijven met behulp van resource-id's naar het gebeurtenislogboek. Maak vervolgens een andere bron zonder resourcebestanden en gebruik die bron in de WriteEntry methode om tekenreeksen rechtstreeks naar het gebeurtenislogboek te schrijven met behulp van die bron.

Zie ook

• Source
• CreateEventSource
• DeleteEventSource(String)
• SourceExists(String)
• Entries

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

public void WriteEntry(string message);

member this.WriteEntry : string -> unit

Public Sub WriteEntry (message As String)

Parameters

Uitzonderingen

Voorbeelden

In het volgende voorbeeld wordt de bron MySource gemaakt als deze nog niet bestaat en schrijft een vermelding naar het gebeurtenislogboek MyNewLog.

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

Opmerkingen

Gebruik deze methode om een informatievermelding te schrijven naar het gebeurtenislogboek dat aan dit EventLog exemplaar is gekoppeld. Als u een andere EventLogEntryTypewilt opgeven, gebruikt u een andere overbelasting van WriteEntry.

U moet de Source eigenschap voor uw EventLog onderdeel instellen voordat u vermeldingen naar het logboek kunt schrijven. U moet de gebeurtenisbron maken en configureren voordat u de eerste vermelding met de bron schrijft.

Maak de nieuwe gebeurtenisbron tijdens de installatie van uw toepassing. Hierdoor kan het besturingssysteem de lijst met geregistreerde gebeurtenisbronnen en hun configuratie vernieuwen. Als het besturingssysteem de lijst met gebeurtenisbronnen niet heeft vernieuwd en u probeert een gebeurtenis te schrijven met de nieuwe bron, mislukt de schrijfbewerking. U kunt een nieuwe bron configureren met behulp van een EventLogInstallerof met behulp van de CreateEventSource methode. U moet beheerdersrechten hebben op de computer om een nieuwe gebeurtenisbron te maken.

Als de bron die is opgegeven in de Source eigenschap van dit EventLog exemplaar niet is geregistreerd op de computer waarnaar uw onderdeel schrijft, WriteEntry roept CreateEventSource u de bron aan en registreert u deze.

Als het systeem de Source door een aanroep WriteEntry moet registreren en de Log eigenschap niet is ingesteld op uw EventLog exemplaar, wordt het logboek standaard ingesteld op het toepassingslogboek.

De bron moet worden geconfigureerd voor het schrijven van gelokaliseerde vermeldingen of voor het schrijven van directe tekenreeksen. De WriteEntry methode schrijft de opgegeven tekenreeks rechtstreeks naar het gebeurtenislogboek. Er wordt geen lokaal berichtbronbestand gebruikt. Gebruik de WriteEvent methode om gebeurtenissen te schrijven met behulp van een gelokaliseerd berichtbronbestand.

Als uw toepassing vermeldingen schrijft met zowel resource-id's als tekenreekswaarden, moet u twee afzonderlijke bronnen registreren. Configureer bijvoorbeeld één bron met resourcebestanden en gebruik die bron in de WriteEvent methode om vermeldingen te schrijven met behulp van resource-id's naar het gebeurtenislogboek. Maak vervolgens een andere bron zonder resourcebestanden en gebruik die bron in de WriteEntry methode om tekenreeksen rechtstreeks naar het gebeurtenislogboek te schrijven met behulp van die bron.

Zie ook

• Source
• CreateEventSource
• DeleteEventSource(String)
• SourceExists(String)
• Entries

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)

Parameters

Uitzonderingen

Voorbeelden

In het volgende voorbeeld wordt een waarschuwingsvermelding naar een gebeurtenislogboek geschreven, 'MyNewLog', op de lokale computer.

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

Opmerkingen

Gebruik deze methode om een vermelding van een opgegeven EventLogEntryType aan het gebeurtenislogboek te schrijven met behulp van een bron die al is geregistreerd als gebeurtenisbron voor het juiste logboek. De type wordt aangegeven door een pictogram en tekst in de kolom Type in de Logboeken voor een logboek.

U moet de gebeurtenisbron maken en configureren voordat u de eerste vermelding met de bron schrijft. Maak de nieuwe gebeurtenisbron tijdens de installatie van uw toepassing. Hierdoor kan het besturingssysteem de lijst met geregistreerde gebeurtenisbronnen en hun configuratie vernieuwen. Als het besturingssysteem de lijst met gebeurtenisbronnen niet heeft vernieuwd en u probeert een gebeurtenis te schrijven met de nieuwe bron, mislukt de schrijfbewerking. U kunt een nieuwe bron configureren met behulp van een EventLogInstallerof met behulp van de CreateEventSource methode. U moet beheerdersrechten hebben op de computer om een nieuwe gebeurtenisbron te maken.

De bron moet worden geconfigureerd voor het schrijven van gelokaliseerde vermeldingen of voor het schrijven van directe tekenreeksen. De WriteEntry methode schrijft de opgegeven tekenreeks rechtstreeks naar het gebeurtenislogboek. Er wordt geen lokaal berichtbronbestand gebruikt. Gebruik de WriteEvent methode om gebeurtenissen te schrijven met behulp van een gelokaliseerd berichtbronbestand.

Als uw toepassing vermeldingen schrijft met zowel resource-id's als tekenreekswaarden, moet u twee afzonderlijke bronnen registreren. Configureer bijvoorbeeld één bron met resourcebestanden en gebruik die bron in de WriteEvent methode om vermeldingen te schrijven met behulp van resource-id's naar het gebeurtenislogboek. Maak vervolgens een andere bron zonder resourcebestanden en gebruik die bron in de WriteEntry methode om tekenreeksen rechtstreeks naar het gebeurtenislogboek te schrijven met behulp van die bron.

Zie ook

• EventLogEntryType
• Source
• CreateEventSource
• DeleteEventSource(String)
• SourceExists(String)
• Entries