EventLog.WriteEntry Metod

Definition

Skriver en post i händelseloggen.

Överlagringar

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

Skriver en post med den angivna meddelandetexten, programdefinierad händelseidentifierare och programdefinierad kategori i händelseloggen (med den angivna registrerade händelsekällan) och lägger till binära data i meddelandet.

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

Skriver en post med angiven meddelandetext, programdefinierad händelseidentifierare och programdefinierad kategori till händelseloggen med den angivna registrerade händelsekällan. category kan användas av Zobrazovač udalostí för att filtrera händelser i loggen.

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

Skriver en post med den angivna meddelandetexten, programdefinierad händelseidentifierare och programdefinierad kategori i händelseloggen och lägger till binära data i meddelandet.

WriteEntry(String, String, EventLogEntryType, Int32)

Skriver en post med angiven meddelandetext och programdefinierad händelseidentifierare till händelseloggen med den angivna registrerade händelsekällan.

WriteEntry(String, EventLogEntryType, Int32, Int16)

Skriver en post med den angivna meddelandetexten, programdefinierad händelseidentifierare och programdefinierad kategori till händelseloggen.

WriteEntry(String, EventLogEntryType)

Skriver ett fel, en varning, information, en lyckad granskning eller en felgranskningspost med den angivna meddelandetexten till händelseloggen.

WriteEntry(String, EventLogEntryType, Int32)

Skriver en post med angiven meddelandetext och programdefinierad händelseidentifierare till händelseloggen.

WriteEntry(String, String)

Skriver en informationstyppost med den angivna meddelandetexten till händelseloggen med den angivna registrerade händelsekällan.

WriteEntry(String)

Skriver en informationstyppost, med den angivna meddelandetexten, till händelseloggen.

WriteEntry(String, String, EventLogEntryType)

Skriver ett fel, en varning, information, en lyckad granskning eller en felgranskningspost med den angivna meddelandetexten till händelseloggen med den angivna registrerade händelsekällan.

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

Skriver en post med den angivna meddelandetexten, programdefinierad händelseidentifierare och programdefinierad kategori i händelseloggen (med den angivna registrerade händelsekällan) och lägger till binära data i meddelandet.

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

Parametrar

source
String

Källan som programmet är registrerat med på den angivna datorn.

message
String

Strängen som ska skrivas till händelseloggen.

type
EventLogEntryType

Ett av EventLogEntryType värdena.

eventID
Int32

Den programspecifika identifieraren för händelsen.

category
Int16

Den programspecifika underkategori som är associerad med meddelandet.

rawData
Byte[]

En matris med byte som innehåller de binära data som är associerade med posten.

Undantag

Värdet source är en tom sträng ("").

-eller-

Värdet source är null.

-eller-

eventID är mindre än noll eller större än UInt16.MaxValue.

-eller-

Meddelandesträngen är längre än 31 839 byte (32 766 byte på Windows operativsystem innan Windows Vista).

-eller-

Källnamnet resulterar i en registernyckelsökväg som är längre än 254 tecken.

type är inte ett giltigt EventLogEntryType.

Det gick inte att öppna registernyckeln för händelseloggen.

Operativsystemet rapporterade ett fel när händelseposten skrevs till händelseloggen. Det finns ingen Windows felkod.

Exempel

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

Kommentarer

Använd den här metoden för att skriva programdefinierade händelsespecifika data till händelseloggen med hjälp av en källa som redan har registrerats som händelsekälla för lämplig logg. Den Zobrazovač udalostí tolkar inte dessa data. Den visar endast rådata i ett kombinerat hexadecimalt format och textformat. Använd händelsespecifika data sparsamt. inkludera det bara om du är säker på att det är användbart. Du kan också använda händelsespecifika data för att lagra information som programmet kan bearbeta oberoende av Zobrazovač udalostí. Du kan till exempel skriva ett visningsprogram specifikt för dina händelser eller skriva ett program som söker igenom loggfilen och skapar rapporter som innehåller information från händelsespecifika data.

Förutom binära data kan du ange en programdefinierad kategori och en programdefinierad händelseidentifierare. Zobrazovač udalostí använder kategorin för att filtrera händelser som skrivits av en händelsekälla. Zobrazovač udalostí kan visa kategorin som ett numeriskt värde eller använda kategorin som resursidentifierare för att visa en lokaliserad kategoristräng.

Note

Parametern category ska vara ett positivt värde. Negativa kategorivärden visas som ett kompletterande positivt tal i Zobrazovač udalostí. Till exempel visas en -10 som 65 526, en -1 som 65 535.

Om du vill visa lokaliserade kategoristrängar i Zobrazovač udalostí måste du använda en händelsekälla som konfigurerats med en kategoriresursfil och ange category till en resursidentifierare i kategoriresursfilen. Om händelsekällan inte har någon konfigurerad kategoriresursfil, eller om den angivna category inte indexera en sträng i kategoriresursfilen, visar Zobrazovač udalostí det numeriska kategorivärdet för posten. Konfigurera kategoriresursfilen, tillsammans med antalet kategoristrängar i resursfilen, med hjälp av EventLogInstaller klassen eller EventSourceCreationData .

Händelseidentifierare, tillsammans med händelsekällan, identifierar en händelse unikt. Varje program kan definiera sina egna numrerade händelser och de beskrivningssträngar som de mappar till. Händelsevisningsprogram visar dessa strängvärden för att hjälpa användaren att förstå vad som gick fel och föreslå vilka åtgärder som ska utföras.

Slutligen kan du ange en EventLogEntryType för händelsen som skrivs till händelseloggen. type visas med en ikon och text i kolumnen Typ i Zobrazovač udalostí för en logg. Den här parametern anger om händelsetypen är fel, varning, information, lyckad granskning eller felgranskning.

Du måste skapa och konfigurera händelsekällan innan du skriver den första posten med källan. Skapa den nya händelsekällan under installationen av programmet. Detta gör det möjligt för operativsystemet att uppdatera sin lista över registrerade händelsekällor och deras konfiguration. Om operativsystemet inte har uppdaterat sin lista över händelsekällor och du försöker skriva en händelse med den nya källan misslyckas skrivåtgärden. Du kan konfigurera en ny källa med hjälp av en EventLogInstaller, eller med hjälp av CreateEventSource metoden . Du måste ha administratörsbehörighet på datorn för att kunna skapa en ny händelsekälla.

Källan måste konfigureras antingen för att skriva lokaliserade poster eller för att skriva direktsträngar. Metoden skriver den angivna strängen direkt till händelseloggen. Den WriteEntry använder inte en lokal meddelanderesursfil. WriteEvent Använd metoden för att skriva händelser med hjälp av en lokaliserad meddelanderesursfil.

Om programmet skriver poster med både resursidentifierare och strängvärden måste du registrera två separata källor. Du kan till exempel konfigurera en källa med resursfiler och sedan använda källan WriteEvent i metoden för att skriva poster med hjälp av resursidentifierare till händelseloggen. Skapa sedan en annan källa utan resursfiler och använd den WriteEntry källan i metoden för att skriva strängar direkt till händelseloggen med den källan.

Note

Om parametern message innehåller ett NUL-tecken avslutas meddelandet i händelseloggen med NUL-tecknet.

Strängen message får inte innehålla %n, där n är ett heltalsvärde (till exempel %1), eftersom loggboken behandlar den som en insättningssträng. Eftersom en IPv6-adress (Internet Protocol, version 6) kan innehålla den här teckensekvensen kan du inte logga ett händelsemeddelande som innehåller en IPv6-adress.

Se även

Gäller för

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

Skriver en post med angiven meddelandetext, programdefinierad händelseidentifierare och programdefinierad kategori till händelseloggen med den angivna registrerade händelsekällan. category kan användas av Zobrazovač udalostí för att filtrera händelser i loggen.

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)

Parametrar

source
String

Källan som programmet är registrerat med på den angivna datorn.

message
String

Strängen som ska skrivas till händelseloggen.

type
EventLogEntryType

Ett av EventLogEntryType värdena.

eventID
Int32

Den programspecifika identifieraren för händelsen.

category
Int16

Den programspecifika underkategori som är associerad med meddelandet.

Undantag

Värdet source är en tom sträng ("").

-eller-

Värdet source är null.

-eller-

eventID är mindre än noll eller större än UInt16.MaxValue.

-eller-

Meddelandesträngen är längre än 31 839 byte (32 766 byte på Windows operativsystem innan Windows Vista).

-eller-

Källnamnet resulterar i en registernyckelsökväg som är längre än 254 tecken.

Det gick inte att öppna registernyckeln för händelseloggen.

type är inte ett giltigt EventLogEntryType.

Operativsystemet rapporterade ett fel när händelseposten skrevs till händelseloggen. Det finns ingen Windows felkod.

Exempel

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)

Kommentarer

Använd den här metoden för att skriva en post med en programdefinierad category till händelseloggen med hjälp av en källa som redan är registrerad som händelsekälla för lämplig logg. Zobrazovač udalostí använder kategorin för att filtrera händelser som skrivits av en händelsekälla. Zobrazovač udalostí kan visa kategorin som ett numeriskt värde eller använda kategorin som resursidentifierare för att visa en lokaliserad kategoristräng.

Note

Parametern category ska vara ett positivt värde. Negativa kategorivärden visas som ett kompletterande positivt tal i Zobrazovač udalostí. Till exempel visas en -10 som 65 526, en -1 som 65 535.

Om du vill visa lokaliserade kategoristrängar i Zobrazovač udalostí måste du använda en händelsekälla som konfigurerats med en kategoriresursfil och ange category till en resursidentifierare i kategoriresursfilen. Om händelsekällan inte har någon konfigurerad kategoriresursfil, eller om den angivna category inte indexera en sträng i kategoriresursfilen, visar Zobrazovač udalostí det numeriska kategorivärdet för posten. Konfigurera kategoriresursfilen, tillsammans med antalet kategoristrängar i resursfilen, med hjälp av EventLogInstaller klassen eller EventSourceCreationData .

Förutom kategorin kan du ange en händelseidentifierare för händelsen som skrivs till händelseloggen. Händelseidentifierare, tillsammans med händelsekällan, identifierar en händelse unikt. Varje program kan definiera sina egna numrerade händelser och de beskrivningssträngar som de mappar till. Händelsevisningsprogram visar dessa strängvärden för att hjälpa användaren att förstå vad som gick fel och föreslå vilka åtgärder som ska utföras.

Slutligen kan du ange en EventLogEntryType för händelsen som skrivs till händelseloggen. type visas med en ikon och text i kolumnen Typ i Zobrazovač udalostí för en logg. Den här parametern anger om händelsetypen är fel, varning, information, lyckad granskning eller felgranskning.

Du måste skapa och konfigurera händelsekällan innan du skriver den första posten med källan. Skapa den nya händelsekällan under installationen av programmet. Detta gör det möjligt för operativsystemet att uppdatera sin lista över registrerade händelsekällor och deras konfiguration. Om operativsystemet inte har uppdaterat sin lista över händelsekällor och du försöker skriva en händelse med den nya källan misslyckas skrivåtgärden. Du kan konfigurera en ny källa med hjälp av en EventLogInstaller, eller med hjälp av CreateEventSource metoden . Du måste ha administratörsbehörighet på datorn för att kunna skapa en ny händelsekälla.

Källan måste konfigureras antingen för att skriva lokaliserade poster eller för att skriva direktsträngar. Metoden skriver den angivna strängen direkt till händelseloggen. Den WriteEntry använder inte en lokal meddelanderesursfil. WriteEvent Använd metoden för att skriva händelser med hjälp av en lokaliserad meddelanderesursfil.

Om programmet skriver poster med både resursidentifierare och strängvärden måste du registrera två separata källor. Du kan till exempel konfigurera en källa med resursfiler och sedan använda källan WriteEvent i metoden för att skriva poster med hjälp av resursidentifierare till händelseloggen. Skapa sedan en annan källa utan resursfiler och använd den WriteEntry källan i metoden för att skriva strängar direkt till händelseloggen med den källan.

Note

Om parametern message innehåller ett NUL-tecken avslutas meddelandet i händelseloggen med NUL-tecknet.

Strängen message får inte innehålla %n, där n är ett heltalsvärde (till exempel %1), eftersom loggboken behandlar den som en insättningssträng. Eftersom en IPv6-adress (Internet Protocol, version 6) kan innehålla den här teckensekvensen kan du inte logga ett händelsemeddelande som innehåller en IPv6-adress.

Se även

Gäller för

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

Skriver en post med den angivna meddelandetexten, programdefinierad händelseidentifierare och programdefinierad kategori i händelseloggen och lägger till binära data i meddelandet.

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

Parametrar

message
String

Strängen som ska skrivas till händelseloggen.

type
EventLogEntryType

Ett av EventLogEntryType värdena.

eventID
Int32

Den programspecifika identifieraren för händelsen.

category
Int16

Den programspecifika underkategori som är associerad med meddelandet.

rawData
Byte[]

En matris med byte som innehåller de binära data som är associerade med posten.

Undantag

Egenskapen Source för EventLog har inte angetts.

-eller-

Metoden försökte registrera en ny händelsekälla, men datornamnet i MachineName är inte giltigt.

-eller-

Källan är redan registrerad för en annan händelselogg.

-eller-

eventID är mindre än noll eller större än UInt16.MaxValue.

-eller-

Meddelandesträngen är längre än 31 839 byte (32 766 byte på Windows operativsystem innan Windows Vista).

-eller-

Källnamnet resulterar i en registernyckelsökväg som är längre än 254 tecken.

Det gick inte att öppna registernyckeln för händelseloggen.

type är inte ett giltigt EventLogEntryType.

Operativsystemet rapporterade ett fel när händelseposten skrevs till händelseloggen. Det finns ingen Windows felkod.

Exempel

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

Kommentarer

Använd den här överlagringen för att skriva programdefinierade händelsespecifika data till händelseloggen. Den Zobrazovač udalostí tolkar inte dessa data. Den visar endast rådata i ett kombinerat hexadecimalt format och textformat. Använd händelsespecifika data sparsamt, inklusive endast om du är säker på att det är användbart för någon som felsöker problemet. Du kan också använda händelsespecifika data för att lagra information som programmet kan bearbeta oberoende av Zobrazovač udalostí. Du kan till exempel skriva ett visningsprogram specifikt för dina händelser eller skriva ett program som söker igenom loggfilen och skapar rapporter som innehåller information från händelsespecifika data.

Förutom binära data kan du ange en programdefinierad kategori och en programdefinierad händelseidentifierare. Zobrazovač udalostí använder kategorin för att filtrera händelser som skrivits av en händelsekälla. Zobrazovač udalostí kan visa kategorin som ett numeriskt värde eller använda kategorin som resursidentifierare för att visa en lokaliserad kategoristräng.

Note

Strängen message får inte innehålla %n, där n är ett heltalsvärde (till exempel %1), eftersom loggboken behandlar den som en insättningssträng. Eftersom en IPv6-adress (Internet Protocol, version 6) kan innehålla den här teckensekvensen kan du inte logga ett händelsemeddelande som innehåller en IPv6-adress.

Note

Parametern category ska vara ett positivt värde. Negativa kategorivärden visas som ett kompletterande positivt tal i Zobrazovač udalostí. Till exempel visas en -10 som 65 526, en -1 som 65 535.

Om du vill visa lokaliserade kategoristrängar i Zobrazovač udalostí måste du använda en händelsekälla som konfigurerats med en kategoriresursfil och ange category till en resursidentifierare i kategoriresursfilen. Om händelsekällan inte har någon konfigurerad kategoriresursfil, eller om den angivna category inte indexera en sträng i kategoriresursfilen, visar Zobrazovač udalostí det numeriska kategorivärdet för posten. Konfigurera kategoriresursfilen, tillsammans med antalet kategoristrängar i resursfilen, med hjälp av EventLogInstaller klassen eller EventSourceCreationData .

Händelseidentifierare, tillsammans med händelsekällan, identifierar en händelse unikt. Varje program kan definiera sina egna numrerade händelser och de beskrivningssträngar som de mappar till. Händelsevisningsprogram visar dessa strängvärden för att hjälpa användaren att förstå vad som gick fel och föreslå vilka åtgärder som ska utföras.

Slutligen kan du ange en EventLogEntryType för händelsen som skrivs till händelseloggen. type visas med en ikon och text i kolumnen Typ i Zobrazovač udalostí för en logg. Den här parametern anger om händelsetypen är fel, varning, information, lyckad granskning eller felgranskning.

Du måste ange egenskapen för Source komponenten EventLog innan du kan skriva poster till loggen. Du måste skapa och konfigurera händelsekällan innan du skriver den första posten med källan.

Skapa den nya händelsekällan under installationen av programmet. Detta gör det möjligt för operativsystemet att uppdatera sin lista över registrerade händelsekällor och deras konfiguration. Om operativsystemet inte har uppdaterat sin lista över händelsekällor och du försöker skriva en händelse med den nya källan misslyckas skrivåtgärden. Du kan konfigurera en ny källa med hjälp av en EventLogInstaller, eller med hjälp av CreateEventSource metoden . Du måste ha administratörsbehörighet på datorn för att kunna skapa en ny händelsekälla.

Om källan som anges i egenskapen för den här EventLog instansen Source inte är registrerad på den dator som komponenten skriver till anropar WriteEntryCreateEventSource och registrerar källan.

Note

Om du inte anger en MachineName för din EventLog instans innan du anropar CreateEventSource eller WriteEntryantas den lokala datorn (".").

Om systemet behöver registrera Source via ett anrop till WriteEntry och Log egenskapen inte har angetts på din EventLog instans, är loggen standard för programloggen.

Note

Många undantag som anges ovan genereras av fel som uppstår under registreringen av Source.

Källan måste konfigureras antingen för att skriva lokaliserade poster eller för att skriva direktsträngar. Metoden skriver den angivna strängen direkt till händelseloggen. Den WriteEntry använder inte en lokal meddelanderesursfil. WriteEvent Använd metoden för att skriva händelser med hjälp av en lokaliserad meddelanderesursfil.

Om programmet skriver poster med både resursidentifierare och strängvärden måste du registrera två separata källor. Du kan till exempel konfigurera en källa med resursfiler och sedan använda källan WriteEvent i metoden för att skriva poster med hjälp av resursidentifierare till händelseloggen. Skapa sedan en annan källa utan resursfiler och använd den WriteEntry källan i metoden för att skriva strängar direkt till händelseloggen med den källan.

Note

Om du skriver en post till en fjärrdator kanske värdet för meddelandet (textsträngen) inte är det du förväntar dig om fjärrdatorn inte kör .NET Framework.

Note

Om parametern message innehåller ett NUL-tecken avslutas meddelandet i händelseloggen med NUL-tecknet.

Se även

Gäller för

WriteEntry(String, String, EventLogEntryType, Int32)

Skriver en post med angiven meddelandetext och programdefinierad händelseidentifierare till händelseloggen med den angivna registrerade händelsekällan.

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)

Parametrar

source
String

Källan som programmet är registrerat med på den angivna datorn.

message
String

Strängen som ska skrivas till händelseloggen.

type
EventLogEntryType

Ett av EventLogEntryType värdena.

eventID
Int32

Den programspecifika identifieraren för händelsen.

Undantag

Värdet source är en tom sträng ("").

-eller-

Värdet source är null.

-eller-

eventID är mindre än noll eller större än UInt16.MaxValue.

-eller-

Meddelandesträngen är längre än 31 839 byte (32 766 byte på Windows operativsystem innan Windows Vista).

-eller-

Källnamnet resulterar i en registernyckelsökväg som är längre än 254 tecken.

Det gick inte att öppna registernyckeln för händelseloggen.

type är inte ett giltigt EventLogEntryType.

Operativsystemet rapporterade ett fel när händelseposten skrevs till händelseloggen. Det finns ingen Windows felkod.

Exempel

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

Kommentarer

Använd den här metoden för att skriva en post med ett programdefinierat eventID till händelseloggen med hjälp av en källa som redan har registrerats som händelsekälla för lämplig logg. , eventIDtillsammans med källan, identifierar en händelse unikt. Varje program kan definiera sina egna numrerade händelser och de beskrivningssträngar som de mappar till. Händelsevisningsanvändare presenterar dessa strängar för användaren för att hjälpa användaren att förstå vad som gick fel och föreslå vilka åtgärder som ska utföras.

Note

Strängen message får inte innehålla %n, där n är ett heltalsvärde (till exempel %1), eftersom loggboken behandlar den som en insättningssträng. Eftersom en IPv6-adress (Internet Protocol, version 6) kan innehålla den här teckensekvensen kan du inte logga ett händelsemeddelande som innehåller en IPv6-adress.

Förutom händelseidentifieraren kan du med den här överbelastningen WriteEntry ange en EventLogEntryType för händelsen som skrivs till händelseloggen. type visas med en ikon och text i kolumnen Typ i Zobrazovač udalostí för en logg. Den här parametern anger om händelsetypen är fel, varning, information, lyckad granskning eller felgranskning.

Du måste skapa och konfigurera händelsekällan innan du skriver den första posten med källan. Skapa den nya händelsekällan under installationen av programmet. Detta gör det möjligt för operativsystemet att uppdatera sin lista över registrerade händelsekällor och deras konfiguration. Om operativsystemet inte har uppdaterat sin lista över händelsekällor och du försöker skriva en händelse med den nya källan misslyckas skrivåtgärden. Du kan konfigurera en ny källa med hjälp av en EventLogInstaller, eller med hjälp av CreateEventSource metoden . Du måste ha administratörsbehörighet på datorn för att kunna skapa en ny händelsekälla.

Källan måste konfigureras antingen för att skriva lokaliserade poster eller för att skriva direktsträngar. Metoden skriver den angivna strängen direkt till händelseloggen. Den WriteEntry använder inte en lokal meddelanderesursfil. WriteEvent Använd metoden för att skriva händelser med hjälp av en lokaliserad meddelanderesursfil.

Om programmet skriver poster med både resursidentifierare och strängvärden måste du registrera två separata källor. Du kan till exempel konfigurera en källa med resursfiler och sedan använda källan WriteEvent i metoden för att skriva poster med hjälp av resursidentifierare till händelseloggen. Skapa sedan en annan källa utan resursfiler och använd den WriteEntry källan i metoden för att skriva strängar direkt till händelseloggen med den källan.

Note

Om parametern message innehåller ett NUL-tecken avslutas meddelandet i händelseloggen med NUL-tecknet.

Se även

Gäller för

WriteEntry(String, EventLogEntryType, Int32, Int16)

Skriver en post med den angivna meddelandetexten, programdefinierad händelseidentifierare och programdefinierad kategori till händelseloggen.

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)

Parametrar

message
String

Strängen som ska skrivas till händelseloggen.

type
EventLogEntryType

Ett av EventLogEntryType värdena.

eventID
Int32

Den programspecifika identifieraren för händelsen.

category
Int16

Den programspecifika underkategori som är associerad med meddelandet.

Undantag

Egenskapen Source för EventLog har inte angetts.

-eller-

Metoden försökte registrera en ny händelsekälla, men datornamnet i MachineName är inte giltigt.

-eller-

Källan är redan registrerad för en annan händelselogg.

-eller-

eventID är mindre än noll eller större än UInt16.MaxValue.

-eller-

Meddelandesträngen är längre än 31 839 byte (32 766 byte på Windows operativsystem innan Windows Vista).

-eller-

Källnamnet resulterar i en registernyckelsökväg som är längre än 254 tecken.

Det gick inte att öppna registernyckeln för händelseloggen.

type är inte ett giltigt EventLogEntryType.

Operativsystemet rapporterade ett fel när händelseposten skrevs till händelseloggen. Det finns ingen Windows felkod.

Exempel

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

Kommentarer

Använd den här metoden för att skriva en post med en programdefinierad category till händelseloggen. Zobrazovač udalostí använder kategorin för att filtrera händelser som skrivits av en händelsekälla. Zobrazovač udalostí kan visa kategorin som ett numeriskt värde eller använda kategorin som resursidentifierare för att visa en lokaliserad kategoristräng.

Note

Parametern category ska vara ett positivt värde. Negativa kategorivärden visas som ett kompletterande positivt tal i Zobrazovač udalostí. Till exempel visas en -10 som 65 526, en -1 som 65 535.

Note

Strängen message får inte innehålla %n, där n är ett heltalsvärde (till exempel %1), eftersom loggboken behandlar den som en insättningssträng. Eftersom en IPv6-adress (Internet Protocol, version 6) kan innehålla den här teckensekvensen kan du inte logga ett händelsemeddelande som innehåller en IPv6-adress.

Om du vill visa lokaliserade kategoristrängar i Zobrazovač udalostí måste du använda en händelsekälla som konfigurerats med en kategoriresursfil och ange category till en resursidentifierare i kategoriresursfilen. Om händelsekällan inte har någon konfigurerad kategoriresursfil, eller om den angivna category inte indexera en sträng i kategoriresursfilen, visar Zobrazovač udalostí det numeriska kategorivärdet för posten. Konfigurera kategoriresursfilen, tillsammans med antalet kategoristrängar i resursfilen, med hjälp av EventLogInstaller klassen eller EventSourceCreationData .

Förutom kategorin kan du ange en händelseidentifierare för händelsen som skrivs till händelseloggen. Händelseidentifierare, tillsammans med händelsekällan, identifierar en händelse unikt. Varje program kan definiera sina egna numrerade händelser och de beskrivningssträngar som de mappar till. Händelsevisningsprogram visar dessa strängvärden för att hjälpa användaren att förstå vad som gick fel och föreslå vilka åtgärder som ska utföras.

Slutligen kan du ange en EventLogEntryType för händelsen som skrivs till händelseloggen. type visas med en ikon och text i kolumnen Typ i Zobrazovač udalostí för en logg. Den här parametern anger om händelsetypen är fel, varning, information, lyckad granskning eller felgranskning.

Du måste ange egenskapen för Source komponenten EventLog innan du kan skriva poster till loggen. Du måste skapa och konfigurera händelsekällan innan du skriver den första posten med källan.

Skapa den nya händelsekällan under installationen av programmet. Detta gör det möjligt för operativsystemet att uppdatera sin lista över registrerade händelsekällor och deras konfiguration. Om operativsystemet inte har uppdaterat sin lista över händelsekällor och du försöker skriva en händelse med den nya källan misslyckas skrivåtgärden. Du kan konfigurera en ny källa med hjälp av en EventLogInstaller, eller med hjälp av CreateEventSource metoden . Du måste ha administratörsbehörighet på datorn för att kunna skapa en ny händelsekälla.

Om källan som anges i egenskapen för den här EventLog instansen Source inte är registrerad på den dator som komponenten skriver till anropar WriteEntryCreateEventSource och registrerar källan.

Note

Om du inte anger en MachineName för din EventLog instans innan du anropar CreateEventSource eller WriteEntryantas den lokala datorn (".").

Om systemet behöver registrera Source via ett anrop till WriteEntry och Log egenskapen inte har angetts på din EventLog instans, är loggen standard för programloggen.

Note

Många undantag som anges ovan genereras av fel som uppstår under registreringen av Source.

Källan måste konfigureras antingen för att skriva lokaliserade poster eller för att skriva direktsträngar. Metoden skriver den angivna strängen direkt till händelseloggen. Den WriteEntry använder inte en lokal meddelanderesursfil. WriteEvent Använd metoden för att skriva händelser med hjälp av en lokaliserad meddelanderesursfil.

Om programmet skriver poster med både resursidentifierare och strängvärden måste du registrera två separata källor. Du kan till exempel konfigurera en källa med resursfiler och sedan använda källan WriteEvent i metoden för att skriva poster med hjälp av resursidentifierare till händelseloggen. Skapa sedan en annan källa utan resursfiler och använd den WriteEntry källan i metoden för att skriva strängar direkt till händelseloggen med den källan.

Note

Om du skriver en post till en fjärrdator kanske värdet för meddelandet (textsträngen) inte är det du förväntar dig om fjärrdatorn inte kör .NET Framework.

Note

Om parametern message innehåller ett NUL-tecken avslutas meddelandet i händelseloggen med NUL-tecknet.

Se även

Gäller för

WriteEntry(String, EventLogEntryType)

Skriver ett fel, en varning, information, en lyckad granskning eller en felgranskningspost med den angivna meddelandetexten till händelseloggen.

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)

Parametrar

message
String

Strängen som ska skrivas till händelseloggen.

type
EventLogEntryType

Ett av EventLogEntryType värdena.

Undantag

Egenskapen Source för EventLog har inte angetts.

-eller-

Metoden försökte registrera en ny händelsekälla, men datornamnet i MachineName är inte giltigt.

-eller-

Källan är redan registrerad för en annan händelselogg.

-eller-

Meddelandesträngen är längre än 31 839 byte (32 766 byte på Windows operativsystem innan Windows Vista).

-eller-

Källnamnet resulterar i en registernyckelsökväg som är längre än 254 tecken.

type är inte ett giltigt EventLogEntryType.

Det gick inte att öppna registernyckeln för händelseloggen.

Operativsystemet rapporterade ett fel när händelseposten skrevs till händelseloggen. Det finns ingen Windows felkod.

Exempel

I följande exempel skrivs en varningspost till en händelselogg, "MyNewLog", på den lokala datorn.

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

Kommentarer

Använd den här metoden för att skriva en post för en angiven EventLogEntryType till händelseloggen. type visas med en ikon och text i kolumnen Typ i Zobrazovač udalostí för en logg.

Note

Strängen message får inte innehålla %n, där n är ett heltalsvärde (till exempel %1), eftersom loggboken behandlar den som en insättningssträng. Eftersom en IPv6-adress (Internet Protocol, version 6) kan innehålla den här teckensekvensen kan du inte logga ett händelsemeddelande som innehåller en IPv6-adress.

Du måste ange egenskapen för Source komponenten EventLog innan du kan skriva poster till loggen. Du måste skapa och konfigurera händelsekällan innan du skriver den första posten med källan.

Skapa den nya händelsekällan under installationen av programmet. Detta gör det möjligt för operativsystemet att uppdatera sin lista över registrerade händelsekällor och deras konfiguration. Om operativsystemet inte har uppdaterat sin lista över händelsekällor och du försöker skriva en händelse med den nya källan misslyckas skrivåtgärden. Du kan konfigurera en ny källa med hjälp av en EventLogInstaller, eller med hjälp av CreateEventSource metoden . Du måste ha administratörsbehörighet på datorn för att kunna skapa en ny händelsekälla.

Om källan som anges i egenskapen för den här EventLog instansen Source inte är registrerad på den dator som komponenten skriver till anropar WriteEntryCreateEventSource och registrerar källan.

Note

Om du inte anger en MachineName för din EventLog instans innan du anropar CreateEventSource eller WriteEntryantas den lokala datorn (".").

Om systemet behöver registrera Source via ett anrop till WriteEntry och Log egenskapen inte har angetts på din EventLog instans, är loggen standard för programloggen.

Note

Många undantag som anges ovan genereras av fel som uppstår under registreringen av Source.

Källan måste konfigureras antingen för att skriva lokaliserade poster eller för att skriva direktsträngar. Metoden skriver den angivna strängen direkt till händelseloggen. Den WriteEntry använder inte en lokal meddelanderesursfil. WriteEvent Använd metoden för att skriva händelser med hjälp av en lokaliserad meddelanderesursfil.

Om programmet skriver poster med både resursidentifierare och strängvärden måste du registrera två separata källor. Du kan till exempel konfigurera en källa med resursfiler och sedan använda källan WriteEvent i metoden för att skriva poster med hjälp av resursidentifierare till händelseloggen. Skapa sedan en annan källa utan resursfiler och använd den WriteEntry källan i metoden för att skriva strängar direkt till händelseloggen med den källan.

Note

Om du skriver en post till en fjärrdator kanske värdet för meddelandet (textsträngen) inte är det du förväntar dig om fjärrdatorn inte kör .NET Framework.

Note

Om parametern message innehåller ett NUL-tecken avslutas meddelandet i händelseloggen med NUL-tecknet.

Se även

Gäller för

WriteEntry(String, EventLogEntryType, Int32)

Skriver en post med angiven meddelandetext och programdefinierad händelseidentifierare till händelseloggen.

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)

Parametrar

message
String

Strängen som ska skrivas till händelseloggen.

type
EventLogEntryType

Ett av EventLogEntryType värdena.

eventID
Int32

Den programspecifika identifieraren för händelsen.

Undantag

Egenskapen Source för EventLog har inte angetts.

-eller-

Metoden försökte registrera en ny händelsekälla, men datornamnet i MachineName är inte giltigt.

-eller-

Källan är redan registrerad för en annan händelselogg.

-eller-

eventID är mindre än noll eller större än UInt16.MaxValue.

-eller-

Meddelandesträngen är längre än 31 839 byte (32 766 byte på Windows operativsystem innan Windows Vista).

-eller-

Källnamnet resulterar i en registernyckelsökväg som är längre än 254 tecken.

Det gick inte att öppna registernyckeln för händelseloggen.

type är inte ett giltigt EventLogEntryType.

Operativsystemet rapporterade ett fel när händelseposten skrevs till händelseloggen. Det finns ingen Windows felkod.

Exempel

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

Kommentarer

Använd den här metoden för att skriva en post med en programdefinierad eventID till händelseloggen. Tillsammans eventID med källan identifierar du en händelse unikt. Varje program kan definiera sina egna numrerade händelser och de beskrivningssträngar som de mappar till. Händelsevisningsprogram visar dessa strängvärden för att hjälpa användaren att förstå vad som gick fel och föreslå vilka åtgärder som ska utföras.

Note

Strängen message får inte innehålla %n, där n är ett heltalsvärde (till exempel %1), eftersom loggboken behandlar den som en insättningssträng. Eftersom en IPv6-adress (Internet Protocol, version 6) kan innehålla den här teckensekvensen kan du inte logga ett händelsemeddelande som innehåller en IPv6-adress.

Förutom händelseidentifieraren kan du ange en EventLogEntryType för händelsen som skrivs till händelseloggen. type visas med en ikon och text i kolumnen Typ i Zobrazovač udalostí för en logg. Den här parametern anger om händelsetypen är fel, varning, information, lyckad granskning eller felgranskning.

Du måste ange egenskapen för Source komponenten EventLog innan du kan skriva poster till loggen. Du måste skapa och konfigurera händelsekällan innan du skriver den första posten med källan.

Skapa den nya händelsekällan under installationen av programmet. Detta gör det möjligt för operativsystemet att uppdatera sin lista över registrerade händelsekällor och deras konfiguration. Om operativsystemet inte har uppdaterat sin lista över händelsekällor och du försöker skriva en händelse med den nya källan misslyckas skrivåtgärden. Du kan konfigurera en ny källa med hjälp av en EventLogInstaller, eller med hjälp av CreateEventSource metoden . Du måste ha administratörsbehörighet på datorn för att kunna skapa en ny händelsekälla.

Om källan som anges i egenskapen för den här EventLog instansen Source inte är registrerad på den dator som komponenten skriver till anropar WriteEntryCreateEventSource och registrerar källan.

Note

Om du inte anger en MachineName för din EventLog instans innan du anropar CreateEventSource eller WriteEntryantas den lokala datorn (".").

Om systemet behöver registrera Source via ett anrop till WriteEntry och Log egenskapen inte har angetts på din EventLog instans, är loggen standard för programloggen.

Note

Många undantag som anges ovan genereras av fel som uppstår under registreringen av Source.

Källan måste konfigureras antingen för att skriva lokaliserade poster eller för att skriva direktsträngar. Metoden skriver den angivna strängen direkt till händelseloggen. Den WriteEntry använder inte en lokal meddelanderesursfil. WriteEvent Använd metoden för att skriva händelser med hjälp av en lokaliserad meddelanderesursfil.

Om programmet skriver poster med både resursidentifierare och strängvärden måste du registrera två separata källor. Du kan till exempel konfigurera en källa med resursfiler och sedan använda källan WriteEvent i metoden för att skriva poster med hjälp av resursidentifierare till händelseloggen. Skapa sedan en annan källa utan resursfiler och använd den WriteEntry källan i metoden för att skriva strängar direkt till händelseloggen med den källan.

Note

Om du skriver en post till en fjärrdator kanske värdet för meddelandet (textsträngen) inte är det du förväntar dig om fjärrdatorn inte kör .NET Framework.

Note

Om parametern message innehåller ett NUL-tecken avslutas meddelandet i händelseloggen med NUL-tecknet.

Se även

Gäller för

WriteEntry(String, String)

Skriver en informationstyppost med den angivna meddelandetexten till händelseloggen med den angivna registrerade händelsekällan.

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)

Parametrar

source
String

Källan som programmet är registrerat med på den angivna datorn.

message
String

Strängen som ska skrivas till händelseloggen.

Undantag

Värdet source är en tom sträng ("").

-eller-

Värdet source är null.

-eller-

Meddelandesträngen är längre än 31 839 byte (32 766 byte på Windows operativsystem innan Windows Vista).

-eller-

Källnamnet resulterar i en registernyckelsökväg som är längre än 254 tecken.

Det gick inte att öppna registernyckeln för händelseloggen.

Operativsystemet rapporterade ett fel när händelseposten skrevs till händelseloggen. Det finns ingen Windows felkod.

Exempel

I följande exempel skapas källan MySource om den inte redan finns och skriver en post till händelseloggen 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

Kommentarer

Använd den här metoden för att skriva en informationspost till händelseloggen med hjälp av en källa som redan är registrerad som händelsekälla för lämplig logg. Om du vill ange någon annan EventLogEntryTypeanvänder du en annan överlagring av WriteEntry.

Du måste skapa och konfigurera händelsekällan innan du skriver den första posten med källan. Skapa den nya händelsekällan under installationen av programmet. Detta gör det möjligt för operativsystemet att uppdatera sin lista över registrerade händelsekällor och deras konfiguration. Om operativsystemet inte har uppdaterat sin lista över händelsekällor och du försöker skriva en händelse med den nya källan misslyckas skrivåtgärden. Du kan konfigurera en ny källa med hjälp av en EventLogInstaller, eller med hjälp av CreateEventSource metoden . Du måste ha administratörsbehörighet på datorn för att kunna skapa en ny händelsekälla.

Källan måste konfigureras antingen för att skriva lokaliserade poster eller för att skriva direktsträngar. Metoden skriver den angivna strängen direkt till händelseloggen. Den WriteEntry använder inte en lokal meddelanderesursfil. WriteEvent Använd metoden för att skriva händelser med hjälp av en lokaliserad meddelanderesursfil.

Om programmet skriver poster med både resursidentifierare och strängvärden måste du registrera två separata källor. Du kan till exempel konfigurera en källa med resursfiler och sedan använda källan WriteEvent i metoden för att skriva poster med hjälp av resursidentifierare till händelseloggen. Skapa sedan en annan källa utan resursfiler och använd den WriteEntry källan i metoden för att skriva strängar direkt till händelseloggen med den källan.

Note

Om parametern message innehåller ett NUL-tecken avslutas meddelandet i händelseloggen med NUL-tecknet.

Strängen message får inte innehålla %n, där n är ett heltalsvärde (till exempel %1), eftersom loggboken behandlar den som en insättningssträng. Eftersom en IPv6-adress (Internet Protocol, version 6) kan innehålla den här teckensekvensen kan du inte logga ett händelsemeddelande som innehåller en IPv6-adress.

Se även

Gäller för

WriteEntry(String)

Skriver en informationstyppost, med den angivna meddelandetexten, till händelseloggen.

public:
 void WriteEntry(System::String ^ message);
public void WriteEntry(string message);
member this.WriteEntry : string -> unit
Public Sub WriteEntry (message As String)

Parametrar

message
String

Strängen som ska skrivas till händelseloggen.

Undantag

Egenskapen Source för EventLog har inte angetts.

-eller-

Metoden försökte registrera en ny händelsekälla, men datornamnet i MachineName är inte giltigt.

-eller-

Källan är redan registrerad för en annan händelselogg.

-eller-

Meddelandesträngen är längre än 31 839 byte (32 766 byte på Windows operativsystem innan Windows Vista).

-eller-

Källnamnet resulterar i en registernyckelsökväg som är längre än 254 tecken.

Det gick inte att öppna registernyckeln för händelseloggen.

Operativsystemet rapporterade ett fel när händelseposten skrevs till händelseloggen. Det finns ingen Windows felkod.

Exempel

I följande exempel skapas källan MySource om den inte redan finns och skriver en post till händelseloggen 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

Kommentarer

Använd den här metoden för att skriva en informationspost till händelseloggen som är associerad med den här EventLog instansen. Om du vill ange någon annan EventLogEntryTypeanvänder du en annan överlagring av WriteEntry.

Note

Strängen message får inte innehålla %n, där n är ett heltalsvärde (till exempel %1), eftersom loggboken behandlar den som en insättningssträng. Eftersom en IPv6-adress (Internet Protocol, version 6) kan innehålla den här teckensekvensen kan du inte logga ett händelsemeddelande som innehåller en IPv6-adress.

Du måste ange egenskapen för Source komponenten EventLog innan du kan skriva poster till loggen. Du måste skapa och konfigurera händelsekällan innan du skriver den första posten med källan.

Skapa den nya händelsekällan under installationen av programmet. Detta gör det möjligt för operativsystemet att uppdatera sin lista över registrerade händelsekällor och deras konfiguration. Om operativsystemet inte har uppdaterat sin lista över händelsekällor och du försöker skriva en händelse med den nya källan misslyckas skrivåtgärden. Du kan konfigurera en ny källa med hjälp av en EventLogInstaller, eller med hjälp av CreateEventSource metoden . Du måste ha administratörsbehörighet på datorn för att kunna skapa en ny händelsekälla.

Om källan som anges i egenskapen för den här EventLog instansen Source inte är registrerad på den dator som komponenten skriver till anropar WriteEntryCreateEventSource och registrerar källan.

Note

Om du inte anger en MachineName för din EventLog instans innan du anropar CreateEventSource eller WriteEntryantas den lokala datorn (".").

Om systemet behöver registrera Source via ett anrop till WriteEntry och Log egenskapen inte har angetts på din EventLog instans, är loggen standard för programloggen.

Note

Många av undantagen som anges ovan genereras av fel som uppstår under registreringen av Source.

Källan måste konfigureras antingen för att skriva lokaliserade poster eller för att skriva direktsträngar. Metoden skriver den angivna strängen direkt till händelseloggen. Den WriteEntry använder inte en lokal meddelanderesursfil. WriteEvent Använd metoden för att skriva händelser med hjälp av en lokaliserad meddelanderesursfil.

Om programmet skriver poster med både resursidentifierare och strängvärden måste du registrera två separata källor. Du kan till exempel konfigurera en källa med resursfiler och sedan använda källan WriteEvent i metoden för att skriva poster med hjälp av resursidentifierare till händelseloggen. Skapa sedan en annan källa utan resursfiler och använd den WriteEntry källan i metoden för att skriva strängar direkt till händelseloggen med den källan.

Note

Om du skriver en post till en fjärrdator kanske värdet för meddelandet (textsträngen) inte är det du förväntar dig om fjärrdatorn inte kör .NET Framework.

Note

Om parametern message innehåller ett NUL-tecken avslutas meddelandet i händelseloggen med NUL-tecknet.

Se även

Gäller för

WriteEntry(String, String, EventLogEntryType)

Skriver ett fel, en varning, information, en lyckad granskning eller en felgranskningspost med den angivna meddelandetexten till händelseloggen med den angivna registrerade händelsekällan.

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)

Parametrar

source
String

Källan som programmet är registrerat med på den angivna datorn.

message
String

Strängen som ska skrivas till händelseloggen.

type
EventLogEntryType

Ett av EventLogEntryType värdena.

Undantag

Värdet source är en tom sträng ("").

-eller-

Värdet source är null.

-eller-

Meddelandesträngen är längre än 31 839 byte (32 766 byte på Windows operativsystem innan Windows Vista).

-eller-

Källnamnet resulterar i en registernyckelsökväg som är längre än 254 tecken.

Det gick inte att öppna registernyckeln för händelseloggen.

type är inte ett giltigt EventLogEntryType.

Operativsystemet rapporterade ett fel när händelseposten skrevs till händelseloggen. Det finns ingen Windows felkod.

Exempel

I följande exempel skrivs en varningspost till en händelselogg, "MyNewLog", på den lokala datorn.

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

Kommentarer

Använd den här metoden för att skriva en post för en angiven EventLogEntryType till händelseloggen med hjälp av en källa som redan har registrerats som händelsekälla för lämplig logg. type visas med en ikon och text i kolumnen Typ i Zobrazovač udalostí för en logg.

Note

Strängen message får inte innehålla %n, där n är ett heltalsvärde (till exempel %1), eftersom loggboken behandlar den som en insättningssträng. Eftersom en IPv6-adress (Internet Protocol, version 6) kan innehålla den här teckensekvensen kan du inte logga ett händelsemeddelande som innehåller en IPv6-adress.

Du måste skapa och konfigurera händelsekällan innan du skriver den första posten med källan. Skapa den nya händelsekällan under installationen av programmet. Detta gör det möjligt för operativsystemet att uppdatera sin lista över registrerade händelsekällor och deras konfiguration. Om operativsystemet inte har uppdaterat sin lista över händelsekällor och du försöker skriva en händelse med den nya källan misslyckas skrivåtgärden. Du kan konfigurera en ny källa med hjälp av en EventLogInstaller, eller med hjälp av CreateEventSource metoden . Du måste ha administratörsbehörighet på datorn för att kunna skapa en ny händelsekälla.

Källan måste konfigureras antingen för att skriva lokaliserade poster eller för att skriva direktsträngar. Metoden skriver den angivna strängen direkt till händelseloggen. Den WriteEntry använder inte en lokal meddelanderesursfil. WriteEvent Använd metoden för att skriva händelser med hjälp av en lokaliserad meddelanderesursfil.

Om programmet skriver poster med både resursidentifierare och strängvärden måste du registrera två separata källor. Du kan till exempel konfigurera en källa med resursfiler och sedan använda källan WriteEvent i metoden för att skriva poster med hjälp av resursidentifierare till händelseloggen. Skapa sedan en annan källa utan resursfiler och använd den WriteEntry källan i metoden för att skriva strängar direkt till händelseloggen med den källan.

Note

Om parametern message innehåller ett NUL-tecken avslutas meddelandet i händelseloggen med NUL-tecknet.

Se även

Gäller för