EventLog.WriteEntry Metódus

Definíció

Bejegyzést ír az eseménynaplóba.

Túlterhelések

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

A megadott üzenetszöveggel, alkalmazás által definiált eseményazonosítóval és alkalmazás által definiált kategóriával rendelkező bejegyzést ír az eseménynaplóba (a megadott regisztrált eseményforrás használatával), és bináris adatokat fűz hozzá az üzenethez.

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

Egy bejegyzést ír az eseménynaplóba a megadott üzenetszöveggel, alkalmazás által definiált eseményazonosítóval és alkalmazás által definiált kategóriával a megadott regisztrált eseményforrás használatával. A category a eseménymegtekintő használhatja a napló eseményeinek szűrésére.

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

A megadott üzenetszöveggel, alkalmazás által definiált eseményazonosítóval és alkalmazás által definiált kategóriával rendelkező bejegyzést ír az eseménynaplóba, és bináris adatokat fűz hozzá az üzenethez.

WriteEntry(String, String, EventLogEntryType, Int32)

Egy bejegyzést ír az eseménynaplóba a megadott üzenetszöveggel és alkalmazás által definiált eseményazonosítóval a megadott regisztrált eseményforrás használatával.

WriteEntry(String, EventLogEntryType, Int32, Int16)

A megadott üzenetszöveggel, alkalmazás által definiált eseményazonosítóval és alkalmazás által definiált kategóriával rendelkező bejegyzést ír az eseménynaplóba.

WriteEntry(String, EventLogEntryType)

Hibaüzenetet, figyelmeztetést, információt, sikeres naplózást vagy hibanapló-bejegyzést ír az eseménynaplóba a megadott üzenetszöveggel.

WriteEntry(String, EventLogEntryType, Int32)

A megadott üzenetszöveggel és alkalmazás által definiált eseményazonosítóval rendelkező bejegyzést ír az eseménynaplóba.

WriteEntry(String, String)

Egy adattípus-bejegyzést ír az eseménynaplóba a megadott üzenetszöveggel a megadott regisztrált eseményforrás használatával.

WriteEntry(String)

Egy adattípus-bejegyzést ír az eseménynaplóba a megadott üzenetszöveggel.

WriteEntry(String, String, EventLogEntryType)

A megadott regisztrált eseményforrás használatával hibaüzenetet, figyelmeztetést, információt, sikeres naplózást vagy hibanapló-bejegyzést ír az eseménynaplóba a megadott üzenetszöveggel.

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

Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs

A megadott üzenetszöveggel, alkalmazás által definiált eseményazonosítóval és alkalmazás által definiált kategóriával rendelkező bejegyzést ír az eseménynaplóba (a megadott regisztrált eseményforrás használatával), és bináris adatokat fűz hozzá az üzenethez.

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);
public static void WriteEntry(string source, string message, System.Diagnostics.EventLogEntryType type, int eventID, short category, byte[] rawData);
static member WriteEntry : string * string * System.Diagnostics.EventLogEntryType * int * int16 * byte[] -> unit
Public Shared Sub WriteEntry (source As String, message As String, type As EventLogEntryType, eventID As Integer, category As Short, rawData As Byte())

Paraméterek

source
String

Az a forrás, amellyel az alkalmazás regisztrálva van a megadott számítógépen.

message
String

Az eseménynaplóba írni kívánt sztring.

type
EventLogEntryType

Az egyik EventLogEntryType érték.

eventID
Int32

Az esemény alkalmazásspecifikus azonosítója.

category
Int16

Az üzenethez társított alkalmazásspecifikus alkategória.

rawData
Byte[]

A bejegyzéshez társított bináris adatokat tartalmazó bájtok tömbje.

Kivételek

Az source érték egy üres sztring ("").

-vagy-

Az source érték a következő null: .

-vagy-

eventID kisebb, mint nulla vagy nagyobb, mint az UInt16.MaxValue.

-vagy-

Az üzenetsztring hosszabb, mint 31 839 bájt (Windows operációs rendszereken 32 766 bájt, mielőtt Windows Vista).

-vagy-

A forrásnév 254 karakternél hosszabb beállításkulcs-elérési utat eredményez.

Az eseménynapló beállításkulcsa nem nyitható meg.

Az operációs rendszer hibát jelentett, amikor az eseménybejegyzést az eseménynaplóba írta. Nem érhető el Windows hibakód.

Példák

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

Megjegyzések

Ezzel a módszerrel alkalmazás által definiált eseményspecifikus adatokat írhat az eseménynaplóba egy olyan forrás használatával, amely már regisztrált eseményforrásként a megfelelő naplóhoz. A eseménymegtekintő nem értelmezi ezeket az adatokat; csak kombinált hexadecimális és szöveges formátumban jeleníti meg a nyers adatokat. Eseményspecifikus adatok takarékos használata; csak akkor vegye fel, ha biztos benne, hogy hasznos lesz. Eseményspecifikus adatokkal is tárolhatja azokat az adatokat, amelyeket az alkalmazás a eseménymegtekintő függetlenül feldolgozhat. Írhat például egy megtekintőt kifejezetten az eseményekhez, vagy írhat egy programot, amely megvizsgálja a naplófájlt, és olyan jelentéseket hoz létre, amelyek tartalmazzák az eseményspecifikus adatokból származó információkat.

A bináris adatokon kívül megadhat egy alkalmazás által definiált kategóriát és egy alkalmazás által definiált eseményazonosítót is. A eseménymegtekintő a kategóriával szűri az eseményforrás által írt eseményeket. A eseménymegtekintő megjelenítheti a kategóriát numerikus értékként, vagy használhatja a kategóriát erőforrás-azonosítóként egy honosított kategóriasztring megjelenítéséhez.

Note

A category paraméternek pozitív értéknek kell lennie. A negatív kategóriaértékek kiegészítő pozitív számként jelennek meg a eseménymegtekintő. Egy -10 például 65 526- ként, egy -1 65 535-ként jelenik meg.

A honosított kategóriasztringek eseménymegtekintő való megjelenítéséhez egy kategóriaerőforrás-fájllal konfigurált eseményforrást kell használnia, és a category erőforrás-azonosítóra kell állítania a kategóriaerőforrás-fájlban. Ha az eseményforrás nem rendelkezik konfigurált kategóriaerőforrás-fájllal, vagy a megadott category nem indexel egy sztringet a kategória erőforrásfájljában, akkor a eseménymegtekintő megjeleníti a bejegyzés numerikus kategóriaértékét. Konfigurálja a kategória-erőforrásfájlt, valamint az erőforrásfájlban lévő kategóriasztringek számát az vagy az EventLogInstallerEventSourceCreationData osztály használatával.

Az eseményazonosítók és az eseményforrás egyedileg azonosítják az eseményeket. Minden alkalmazás meghatározhatja a saját számozott eseményeit és azokat a leírási sztringeket, amelyekre leképezett. Az eseménymegjelenítők megjelenítik ezeket a sztringértékeket, hogy a felhasználó megértse, mi történt, és javaslatot tegyen a végrehajtandó műveletekre.

Végül megadhatja EventLogEntryType az eseménynaplóba írt eseményt. A type egy ikon és egy szöveg jelzi a napló eseménymegtekintő Típus oszlopában. Ez a paraméter azt jelzi, hogy az esemény típusa hiba, figyelmeztetés, információ, sikeres naplózás vagy hibanaplózás.

Az első bejegyzés forrással való írása előtt létre kell hoznia és konfigurálnia kell az eseményforrást. Hozza létre az új eseményforrást az alkalmazás telepítése során. Ez lehetővé teszi, hogy az operációs rendszer frissítse a regisztrált eseményforrások listáját és azok konfigurációját. Ha az operációs rendszer nem frissítette az eseményforrások listáját, és egy eseményt próbál meg írni az új forrással, az írási művelet sikertelen lesz. Új forrást konfigurálhat egy EventLogInstaller, vagy a CreateEventSource metódus használatával. Új eseményforrás létrehozásához rendszergazdai jogosultságokkal kell rendelkeznie a számítógépen.

A forrást honosított bejegyzések írására vagy közvetlen sztringek írására kell konfigurálni. A WriteEntry metódus közvetlenül az eseménynaplóba írja a megadott sztringet, nem használ honosítható üzenet erőforrásfájlt. A metódussal WriteEvent eseményeket írhat egy honosított üzeneterőforrás-fájllal.

Ha az alkalmazás erőforrás-azonosítók és sztringértékek használatával is ír bejegyzéseket, két különálló forrást kell regisztrálnia. Konfiguráljon például egy forrást erőforrásfájlokkal, majd használja ezt a forrást a WriteEvent metódusban bejegyzések írásához erőforrás-azonosítók használatával az eseménynaplóba. Ezután hozzon létre egy másik forrást erőforrásfájlok nélkül, és használja ezt a forrást a WriteEntry metódusban, hogy sztringeket írjon közvetlenül az eseménynaplóba ezzel a forrással.

Note

Ha a message paraméter NUL-karaktert tartalmaz, az eseménynaplóban szereplő üzenet az NUL karakterrel végződik.

A message sztring nem tartalmazhat %n értéket, ahol az n egész szám (például %1), mert az eseménynapló beszúrási sztringként kezeli. Mivel az Internet Protocol 6-os (IPv6-) verziója tartalmazhatja ezt a karaktersorozatot, nem naplózhat IPv6-címet tartalmazó eseményüzenetet.

Lásd még

A következőre érvényes:

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

Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs

Egy bejegyzést ír az eseménynaplóba a megadott üzenetszöveggel, alkalmazás által definiált eseményazonosítóval és alkalmazás által definiált kategóriával a megadott regisztrált eseményforrás használatával. A category a eseménymegtekintő használhatja a napló eseményeinek szűrésére.

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);
public static void WriteEntry(string source, string message, System.Diagnostics.EventLogEntryType type, int eventID, short category);
static member WriteEntry : string * string * System.Diagnostics.EventLogEntryType * int * int16 -> unit
Public Shared Sub WriteEntry (source As String, message As String, type As EventLogEntryType, eventID As Integer, category As Short)

Paraméterek

source
String

Az a forrás, amellyel az alkalmazás regisztrálva van a megadott számítógépen.

message
String

Az eseménynaplóba írni kívánt sztring.

type
EventLogEntryType

Az egyik EventLogEntryType érték.

eventID
Int32

Az esemény alkalmazásspecifikus azonosítója.

category
Int16

Az üzenethez társított alkalmazásspecifikus alkategória.

Kivételek

Az source érték egy üres sztring ("").

-vagy-

Az source érték a következő null: .

-vagy-

eventID kisebb, mint nulla vagy nagyobb, mint az UInt16.MaxValue.

-vagy-

Az üzenetsztring hosszabb, mint 31 839 bájt (Windows operációs rendszereken 32 766 bájt, mielőtt Windows Vista).

-vagy-

A forrásnév 254 karakternél hosszabb beállításkulcs-elérési utat eredményez.

Az eseménynapló beállításkulcsa nem nyitható meg.

Az operációs rendszer hibát jelentett, amikor az eseménybejegyzést az eseménynaplóba írta. Nem érhető el Windows hibakód.

Példák

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)

Megjegyzések

Ezzel a módszerrel olyan bejegyzést írhat az eseménynaplóba egy alkalmazás által definiált category alkalmazással, amely egy olyan forrást használ, amely már regisztrálva van a megfelelő napló eseményforrásaként. A eseménymegtekintő a kategóriával szűri az eseményforrás által írt eseményeket. A eseménymegtekintő megjelenítheti a kategóriát numerikus értékként, vagy használhatja a kategóriát erőforrás-azonosítóként egy honosított kategóriasztring megjelenítéséhez.

Note

A category paraméternek pozitív értéknek kell lennie. A negatív kategóriaértékek kiegészítő pozitív számként jelennek meg a eseménymegtekintő. Egy -10 például 65 526- ként, egy -1 65 535-ként jelenik meg.

A honosított kategóriasztringek eseménymegtekintő való megjelenítéséhez egy kategóriaerőforrás-fájllal konfigurált eseményforrást kell használnia, és a category erőforrás-azonosítóra kell állítania a kategóriaerőforrás-fájlban. Ha az eseményforrás nem rendelkezik konfigurált kategóriaerőforrás-fájllal, vagy a megadott category nem indexel egy sztringet a kategória erőforrásfájljában, akkor a eseménymegtekintő megjeleníti a bejegyzés numerikus kategóriaértékét. Konfigurálja a kategória-erőforrásfájlt, valamint az erőforrásfájlban lévő kategóriasztringek számát az vagy az EventLogInstallerEventSourceCreationData osztály használatával.

A kategória mellett megadhatja az eseménynaplóba írt esemény eseményazonosítóját is. Az eseményazonosítók és az eseményforrás egyedileg azonosítják az eseményeket. Minden alkalmazás meghatározhatja a saját számozott eseményeit és azokat a leírási sztringeket, amelyekre leképezett. Az eseménymegjelenítők megjelenítik ezeket a sztringértékeket, hogy a felhasználó megértse, mi történt, és javaslatot tegyen a végrehajtandó műveletekre.

Végül megadhatja EventLogEntryType az eseménynaplóba írt eseményt. A type egy ikon és egy szöveg jelzi a napló eseménymegtekintő Típus oszlopában. Ez a paraméter azt jelzi, hogy az esemény típusa hiba, figyelmeztetés, információ, sikeres naplózás vagy hibanaplózás.

Az első bejegyzés forrással való írása előtt létre kell hoznia és konfigurálnia kell az eseményforrást. Hozza létre az új eseményforrást az alkalmazás telepítése során. Ez lehetővé teszi, hogy az operációs rendszer frissítse a regisztrált eseményforrások listáját és azok konfigurációját. Ha az operációs rendszer nem frissítette az eseményforrások listáját, és egy eseményt próbál meg írni az új forrással, az írási művelet sikertelen lesz. Új forrást konfigurálhat egy EventLogInstaller, vagy a CreateEventSource metódus használatával. Új eseményforrás létrehozásához rendszergazdai jogosultságokkal kell rendelkeznie a számítógépen.

A forrást honosított bejegyzések írására vagy közvetlen sztringek írására kell konfigurálni. A WriteEntry metódus közvetlenül az eseménynaplóba írja a megadott sztringet, nem használ honosítható üzenet erőforrásfájlt. A metódussal WriteEvent eseményeket írhat egy honosított üzeneterőforrás-fájllal.

Ha az alkalmazás erőforrás-azonosítók és sztringértékek használatával is ír bejegyzéseket, két különálló forrást kell regisztrálnia. Konfiguráljon például egy forrást erőforrásfájlokkal, majd használja ezt a forrást a WriteEvent metódusban bejegyzések írásához erőforrás-azonosítók használatával az eseménynaplóba. Ezután hozzon létre egy másik forrást erőforrásfájlok nélkül, és használja ezt a forrást a WriteEntry metódusban, hogy sztringeket írjon közvetlenül az eseménynaplóba ezzel a forrással.

Note

Ha a message paraméter NUL-karaktert tartalmaz, az eseménynaplóban szereplő üzenet az NUL karakterrel végződik.

A message sztring nem tartalmazhat %n értéket, ahol az n egész szám (például %1), mert az eseménynapló beszúrási sztringként kezeli. Mivel az Internet Protocol 6-os (IPv6-) verziója tartalmazhatja ezt a karaktersorozatot, nem naplózhat IPv6-címet tartalmazó eseményüzenetet.

Lásd még

A következőre érvényes:

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

Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs

A megadott üzenetszöveggel, alkalmazás által definiált eseményazonosítóval és alkalmazás által definiált kategóriával rendelkező bejegyzést ír az eseménynaplóba, és bináris adatokat fűz hozzá az üzenethez.

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);
public void WriteEntry(string message, System.Diagnostics.EventLogEntryType type, int eventID, short category, byte[] rawData);
member this.WriteEntry : string * System.Diagnostics.EventLogEntryType * int * int16 * byte[] -> unit
Public Sub WriteEntry (message As String, type As EventLogEntryType, eventID As Integer, category As Short, rawData As Byte())

Paraméterek

message
String

Az eseménynaplóba írni kívánt sztring.

type
EventLogEntryType

Az egyik EventLogEntryType érték.

eventID
Int32

Az esemény alkalmazásspecifikus azonosítója.

category
Int16

Az üzenethez társított alkalmazásspecifikus alkategória.

rawData
Byte[]

A bejegyzéshez társított bináris adatokat tartalmazó bájtok tömbje.

Kivételek

A Source tulajdonság EventLog nincs beállítva.

-vagy-

A metódus új eseményforrást próbált regisztrálni, de a számítógép neve MachineName érvénytelen.

-vagy-

A forrás már regisztrálva van egy másik eseménynaplóhoz.

-vagy-

eventID kisebb, mint nulla vagy nagyobb, mint az UInt16.MaxValue.

-vagy-

Az üzenetsztring hosszabb, mint 31 839 bájt (Windows operációs rendszereken 32 766 bájt, mielőtt Windows Vista).

-vagy-

A forrásnév 254 karakternél hosszabb beállításkulcs-elérési utat eredményez.

Az eseménynapló beállításkulcsa nem nyitható meg.

Az operációs rendszer hibát jelentett, amikor az eseménybejegyzést az eseménynaplóba írta. Nem érhető el Windows hibakód.

Példák

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

Megjegyzések

Ezzel a túlterhelést használva alkalmazás által meghatározott eseményspecifikus adatokat írhat az eseménynaplóba. A eseménymegtekintő nem értelmezi ezeket az adatokat; csak kombinált hexadecimális és szöveges formátumban jeleníti meg a nyers adatokat. Használjon eseményspecifikus adatokat takarékosan, beleértve csak akkor, ha biztos benne, hogy hasznos lesz a probléma hibakeresése. Eseményspecifikus adatokkal is tárolhatja azokat az adatokat, amelyeket az alkalmazás a eseménymegtekintő függetlenül feldolgozhat. Írhat például egy megtekintőt kifejezetten az eseményekhez, vagy írhat egy programot, amely megvizsgálja a naplófájlt, és olyan jelentéseket hoz létre, amelyek tartalmazzák az eseményspecifikus adatokból származó információkat.

A bináris adatokon kívül megadhat egy alkalmazás által definiált kategóriát és egy alkalmazás által definiált eseményazonosítót is. A eseménymegtekintő a kategóriával szűri az eseményforrás által írt eseményeket. A eseménymegtekintő megjelenítheti a kategóriát numerikus értékként, vagy használhatja a kategóriát erőforrás-azonosítóként egy honosított kategóriasztring megjelenítéséhez.

Note

A message sztring nem tartalmazhat %n értéket, ahol az n egész szám (például %1), mert az eseménynapló beszúrási sztringként kezeli. Mivel az Internet Protocol 6-os (IPv6-) verziója tartalmazhatja ezt a karaktersorozatot, nem naplózhat IPv6-címet tartalmazó eseményüzenetet.

Note

A category paraméternek pozitív értéknek kell lennie. A negatív kategóriaértékek kiegészítő pozitív számként jelennek meg a eseménymegtekintő. Egy -10 például 65 526- ként, egy -1 65 535-ként jelenik meg.

A honosított kategóriasztringek eseménymegtekintő való megjelenítéséhez egy kategóriaerőforrás-fájllal konfigurált eseményforrást kell használnia, és a category erőforrás-azonosítóra kell állítania a kategóriaerőforrás-fájlban. Ha az eseményforrás nem rendelkezik konfigurált kategóriaerőforrás-fájllal, vagy a megadott category nem indexel egy sztringet a kategória erőforrásfájljában, akkor a eseménymegtekintő megjeleníti a bejegyzés numerikus kategóriaértékét. Konfigurálja a kategória-erőforrásfájlt, valamint az erőforrásfájlban lévő kategóriasztringek számát az vagy az EventLogInstallerEventSourceCreationData osztály használatával.

Az eseményazonosítók és az eseményforrás egyedileg azonosítják az eseményeket. Minden alkalmazás meghatározhatja a saját számozott eseményeit és azokat a leírási sztringeket, amelyekre leképezett. Az eseménymegjelenítők megjelenítik ezeket a sztringértékeket, hogy a felhasználó megértse, mi történt, és javaslatot tegyen a végrehajtandó műveletekre.

Végül megadhatja EventLogEntryType az eseménynaplóba írt eseményt. A type egy ikon és egy szöveg jelzi a napló eseménymegtekintő Típus oszlopában. Ez a paraméter azt jelzi, hogy az esemény típusa hiba, figyelmeztetés, információ, sikeres naplózás vagy hibanaplózás.

Mielőtt bejegyzéseket írhat a naplóba, be kell állítania a SourceEventLog tulajdonságot az összetevőn. Az első bejegyzés forrással való írása előtt létre kell hoznia és konfigurálnia kell az eseményforrást.

Hozza létre az új eseményforrást az alkalmazás telepítése során. Ez lehetővé teszi, hogy az operációs rendszer frissítse a regisztrált eseményforrások listáját és azok konfigurációját. Ha az operációs rendszer nem frissítette az eseményforrások listáját, és egy eseményt próbál meg írni az új forrással, az írási művelet sikertelen lesz. Új forrást konfigurálhat egy EventLogInstaller, vagy a CreateEventSource metódus használatával. Új eseményforrás létrehozásához rendszergazdai jogosultságokkal kell rendelkeznie a számítógépen.

Ha a példány tulajdonságában SourceEventLog megadott forrás nincs regisztrálva azon a számítógépen, amelyen az összetevő ír, WriteEntry meghívja CreateEventSource és regisztrálja a forrást.

Note

Ha a hívás MachineName előtt nem ad EventLog meg egy példánytCreateEventSource, a WriteEntryrendszer feltételezi a helyi számítógép (".") megadását.

Ha a rendszernek egy híváson Source keresztül kell regisztrálnia, WriteEntry és a Log tulajdonság nincs beállítva a EventLog példányon, a napló alapértelmezés szerint az alkalmazásnaplóba lesz beállítva.

Note

A fent felsorolt kivételek közül számosat a regisztráció során felmerülő hibák okoznak Source.

A forrást honosított bejegyzések írására vagy közvetlen sztringek írására kell konfigurálni. A WriteEntry metódus közvetlenül az eseménynaplóba írja a megadott sztringet, nem használ honosítható üzenet erőforrásfájlt. A metódussal WriteEvent eseményeket írhat egy honosított üzeneterőforrás-fájllal.

Ha az alkalmazás erőforrás-azonosítók és sztringértékek használatával is ír bejegyzéseket, két különálló forrást kell regisztrálnia. Konfiguráljon például egy forrást erőforrásfájlokkal, majd használja ezt a forrást a WriteEvent metódusban bejegyzések írásához erőforrás-azonosítók használatával az eseménynaplóba. Ezután hozzon létre egy másik forrást erőforrásfájlok nélkül, és használja ezt a forrást a WriteEntry metódusban, hogy sztringeket írjon közvetlenül az eseménynaplóba ezzel a forrással.

Note

Ha egy bejegyzést egy távoli számítógépre ír, előfordulhat, hogy az üzenet értéke (a szöveges sztring) nem az, amit vár, ha a távoli számítógép nem a .NET-keretrendszert futtatja.

Note

Ha a message paraméter NUL-karaktert tartalmaz, az eseménynaplóban szereplő üzenet az NUL karakterrel végződik.

Lásd még

A következőre érvényes:

WriteEntry(String, String, EventLogEntryType, Int32)

Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs

Egy bejegyzést ír az eseménynaplóba a megadott üzenetszöveggel és alkalmazás által definiált eseményazonosítóval a megadott regisztrált eseményforrás használatával.

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);
public static void WriteEntry(string source, string message, System.Diagnostics.EventLogEntryType type, int eventID);
static member WriteEntry : string * string * System.Diagnostics.EventLogEntryType * int -> unit
Public Shared Sub WriteEntry (source As String, message As String, type As EventLogEntryType, eventID As Integer)

Paraméterek

source
String

Az a forrás, amellyel az alkalmazás regisztrálva van a megadott számítógépen.

message
String

Az eseménynaplóba írni kívánt sztring.

type
EventLogEntryType

Az egyik EventLogEntryType érték.

eventID
Int32

Az esemény alkalmazásspecifikus azonosítója.

Kivételek

Az source érték egy üres sztring ("").

-vagy-

Az source érték a következő null: .

-vagy-

eventID kisebb, mint nulla vagy nagyobb, mint az UInt16.MaxValue.

-vagy-

Az üzenetsztring hosszabb, mint 31 839 bájt (Windows operációs rendszereken 32 766 bájt, mielőtt Windows Vista).

-vagy-

A forrásnév 254 karakternél hosszabb beállításkulcs-elérési utat eredményez.

Az eseménynapló beállításkulcsa nem nyitható meg.

Az operációs rendszer hibát jelentett, amikor az eseménybejegyzést az eseménynaplóba írta. Nem érhető el Windows hibakód.

Példák

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

Megjegyzések

Ezzel a módszerrel egy, az eseménynaplóba meghatározott eventID alkalmazással rendelkező bejegyzést írhat egy olyan forrás használatával, amely már regisztrálva van eseményforrásként a megfelelő naplóhoz. A eventIDforrással együtt egyedileg azonosít egy eseményt. Minden alkalmazás meghatározhatja a saját számozott eseményeit és azokat a leírási sztringeket, amelyekre leképezett. Az eseménynaplók ezeket a sztringeket mutatják be a felhasználónak, hogy segítsenek a felhasználónak megérteni a hibát, és javasolni tudják, hogy milyen műveleteket kell végrehajtani.

Note

A message sztring nem tartalmazhat %n értéket, ahol az n egész szám (például %1), mert az eseménynapló beszúrási sztringként kezeli. Mivel az Internet Protocol 6-os (IPv6-) verziója tartalmazhatja ezt a karaktersorozatot, nem naplózhat IPv6-címet tartalmazó eseményüzenetet.

Az eseményazonosító mellett ez a túlterhelés WriteEntry lehetővé teszi az EventLogEntryType eseménynaplóba írt esemény megadását. A type egy ikon és egy szöveg jelzi a napló eseménymegtekintő Típus oszlopában. Ez a paraméter azt jelzi, hogy az esemény típusa hiba, figyelmeztetés, információ, sikeres naplózás vagy hibanaplózás.

Az első bejegyzés forrással való írása előtt létre kell hoznia és konfigurálnia kell az eseményforrást. Hozza létre az új eseményforrást az alkalmazás telepítése során. Ez lehetővé teszi, hogy az operációs rendszer frissítse a regisztrált eseményforrások listáját és azok konfigurációját. Ha az operációs rendszer nem frissítette az eseményforrások listáját, és egy eseményt próbál meg írni az új forrással, az írási művelet sikertelen lesz. Új forrást konfigurálhat egy EventLogInstaller, vagy a CreateEventSource metódus használatával. Új eseményforrás létrehozásához rendszergazdai jogosultságokkal kell rendelkeznie a számítógépen.

A forrást honosított bejegyzések írására vagy közvetlen sztringek írására kell konfigurálni. A WriteEntry metódus közvetlenül az eseménynaplóba írja a megadott sztringet, nem használ honosítható üzenet erőforrásfájlt. A metódussal WriteEvent eseményeket írhat egy honosított üzeneterőforrás-fájllal.

Ha az alkalmazás erőforrás-azonosítók és sztringértékek használatával is ír bejegyzéseket, két különálló forrást kell regisztrálnia. Konfiguráljon például egy forrást erőforrásfájlokkal, majd használja ezt a forrást a WriteEvent metódusban bejegyzések írásához erőforrás-azonosítók használatával az eseménynaplóba. Ezután hozzon létre egy másik forrást erőforrásfájlok nélkül, és használja ezt a forrást a WriteEntry metódusban, hogy sztringeket írjon közvetlenül az eseménynaplóba ezzel a forrással.

Note

Ha a message paraméter NUL-karaktert tartalmaz, az eseménynaplóban szereplő üzenet az NUL karakterrel végződik.

Lásd még

A következőre érvényes:

WriteEntry(String, EventLogEntryType, Int32, Int16)

Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs

A megadott üzenetszöveggel, alkalmazás által definiált eseményazonosítóval és alkalmazás által definiált kategóriával rendelkező bejegyzést ír az eseménynaplóba.

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);
public void WriteEntry(string message, System.Diagnostics.EventLogEntryType type, int eventID, short category);
member this.WriteEntry : string * System.Diagnostics.EventLogEntryType * int * int16 -> unit
Public Sub WriteEntry (message As String, type As EventLogEntryType, eventID As Integer, category As Short)

Paraméterek

message
String

Az eseménynaplóba írni kívánt sztring.

type
EventLogEntryType

Az egyik EventLogEntryType érték.

eventID
Int32

Az esemény alkalmazásspecifikus azonosítója.

category
Int16

Az üzenethez társított alkalmazásspecifikus alkategória.

Kivételek

A Source tulajdonság EventLog nincs beállítva.

-vagy-

A metódus új eseményforrást próbált regisztrálni, de a számítógép neve MachineName érvénytelen.

-vagy-

A forrás már regisztrálva van egy másik eseménynaplóhoz.

-vagy-

eventID kisebb, mint nulla vagy nagyobb, mint az UInt16.MaxValue.

-vagy-

Az üzenetsztring hosszabb, mint 31 839 bájt (Windows operációs rendszereken 32 766 bájt, mielőtt Windows Vista).

-vagy-

A forrásnév 254 karakternél hosszabb beállításkulcs-elérési utat eredményez.

Az eseménynapló beállításkulcsa nem nyitható meg.

Az operációs rendszer hibát jelentett, amikor az eseménybejegyzést az eseménynaplóba írta. Nem érhető el Windows hibakód.

Példák

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

Megjegyzések

Ezzel a módszerrel egy bejegyzést írhat az eseménynaplóba egy alkalmazás által definiált category alkalmazással. A eseménymegtekintő a kategóriával szűri az eseményforrás által írt eseményeket. A eseménymegtekintő megjelenítheti a kategóriát numerikus értékként, vagy használhatja a kategóriát erőforrás-azonosítóként egy honosított kategóriasztring megjelenítéséhez.

Note

A category paraméternek pozitív értéknek kell lennie. A negatív kategóriaértékek kiegészítő pozitív számként jelennek meg a eseménymegtekintő. Egy -10 például 65 526- ként, egy -1 65 535-ként jelenik meg.

Note

A message sztring nem tartalmazhat %n értéket, ahol az n egész szám (például %1), mert az eseménynapló beszúrási sztringként kezeli. Mivel az Internet Protocol 6-os (IPv6-) verziója tartalmazhatja ezt a karaktersorozatot, nem naplózhat IPv6-címet tartalmazó eseményüzenetet.

A honosított kategóriasztringek eseménymegtekintő való megjelenítéséhez egy kategóriaerőforrás-fájllal konfigurált eseményforrást kell használnia, és a category erőforrás-azonosítóra kell állítania a kategóriaerőforrás-fájlban. Ha az eseményforrás nem rendelkezik konfigurált kategóriaerőforrás-fájllal, vagy a megadott category nem indexel egy sztringet a kategória erőforrásfájljában, akkor a eseménymegtekintő megjeleníti a bejegyzés numerikus kategóriaértékét. Konfigurálja a kategória-erőforrásfájlt, valamint az erőforrásfájlban lévő kategóriasztringek számát az vagy az EventLogInstallerEventSourceCreationData osztály használatával.

A kategória mellett megadhatja az eseménynaplóba írt esemény eseményazonosítóját is. Az eseményazonosítók és az eseményforrás egyedileg azonosítják az eseményeket. Minden alkalmazás meghatározhatja a saját számozott eseményeit és azokat a leírási sztringeket, amelyekre leképezett. Az eseménymegjelenítők megjelenítik ezeket a sztringértékeket, hogy a felhasználó megértse, mi történt, és javaslatot tegyen a végrehajtandó műveletekre.

Végül megadhatja EventLogEntryType az eseménynaplóba írt eseményt. A type egy ikon és egy szöveg jelzi a napló eseménymegtekintő Típus oszlopában. Ez a paraméter azt jelzi, hogy az esemény típusa hiba, figyelmeztetés, információ, sikeres naplózás vagy hibanaplózás.

Mielőtt bejegyzéseket írhat a naplóba, be kell állítania a SourceEventLog tulajdonságot az összetevőn. Az első bejegyzés forrással való írása előtt létre kell hoznia és konfigurálnia kell az eseményforrást.

Hozza létre az új eseményforrást az alkalmazás telepítése során. Ez lehetővé teszi, hogy az operációs rendszer frissítse a regisztrált eseményforrások listáját és azok konfigurációját. Ha az operációs rendszer nem frissítette az eseményforrások listáját, és egy eseményt próbál meg írni az új forrással, az írási művelet sikertelen lesz. Új forrást konfigurálhat egy EventLogInstaller, vagy a CreateEventSource metódus használatával. Új eseményforrás létrehozásához rendszergazdai jogosultságokkal kell rendelkeznie a számítógépen.

Ha a példány tulajdonságában SourceEventLog megadott forrás nincs regisztrálva azon a számítógépen, amelyen az összetevő ír, WriteEntry meghívja CreateEventSource és regisztrálja a forrást.

Note

Ha a hívás MachineName előtt nem ad EventLog meg egy példánytCreateEventSource, a WriteEntryrendszer feltételezi a helyi számítógép (".") megadását.

Ha a rendszernek egy híváson Source keresztül kell regisztrálnia, WriteEntry és a Log tulajdonság nincs beállítva a EventLog példányon, a napló alapértelmezés szerint az alkalmazásnaplóba lesz beállítva.

Note

A fent felsorolt kivételek közül számosat a regisztráció során felmerülő hibák okoznak Source.

A forrást honosított bejegyzések írására vagy közvetlen sztringek írására kell konfigurálni. A WriteEntry metódus közvetlenül az eseménynaplóba írja a megadott sztringet, nem használ honosítható üzenet erőforrásfájlt. A metódussal WriteEvent eseményeket írhat egy honosított üzeneterőforrás-fájllal.

Ha az alkalmazás erőforrás-azonosítók és sztringértékek használatával is ír bejegyzéseket, két különálló forrást kell regisztrálnia. Konfiguráljon például egy forrást erőforrásfájlokkal, majd használja ezt a forrást a WriteEvent metódusban bejegyzések írásához erőforrás-azonosítók használatával az eseménynaplóba. Ezután hozzon létre egy másik forrást erőforrásfájlok nélkül, és használja ezt a forrást a WriteEntry metódusban, hogy sztringeket írjon közvetlenül az eseménynaplóba ezzel a forrással.

Note

Ha egy bejegyzést egy távoli számítógépre ír, előfordulhat, hogy az üzenet értéke (a szöveges sztring) nem az, amit vár, ha a távoli számítógép nem a .NET-keretrendszert futtatja.

Note

Ha a message paraméter NUL-karaktert tartalmaz, az eseménynaplóban szereplő üzenet az NUL karakterrel végződik.

Lásd még

A következőre érvényes:

WriteEntry(String, EventLogEntryType)

Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs

Hibaüzenetet, figyelmeztetést, információt, sikeres naplózást vagy hibanapló-bejegyzést ír az eseménynaplóba a megadott üzenetszöveggel.

public:
 void WriteEntry(System::String ^ message, System::Diagnostics::EventLogEntryType type);
public void WriteEntry(string? message, System.Diagnostics.EventLogEntryType type);
public void WriteEntry(string message, System.Diagnostics.EventLogEntryType type);
member this.WriteEntry : string * System.Diagnostics.EventLogEntryType -> unit
Public Sub WriteEntry (message As String, type As EventLogEntryType)

Paraméterek

message
String

Az eseménynaplóba írni kívánt sztring.

type
EventLogEntryType

Az egyik EventLogEntryType érték.

Kivételek

A Source tulajdonság EventLog nincs beállítva.

-vagy-

A metódus új eseményforrást próbált regisztrálni, de a számítógép neve MachineName érvénytelen.

-vagy-

A forrás már regisztrálva van egy másik eseménynaplóhoz.

-vagy-

Az üzenetsztring hosszabb, mint 31 839 bájt (Windows operációs rendszereken 32 766 bájt, mielőtt Windows Vista).

-vagy-

A forrásnév 254 karakternél hosszabb beállításkulcs-elérési utat eredményez.

Az eseménynapló beállításkulcsa nem nyitható meg.

Az operációs rendszer hibát jelentett, amikor az eseménybejegyzést az eseménynaplóba írta. Nem érhető el Windows hibakód.

Példák

Az alábbi példa egy figyelmeztető bejegyzést ír a helyi számítógépen található "MyNewLog" eseménynaplóba.

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

Megjegyzések

Ezzel a módszerrel egy megadott EventLogEntryType bejegyzést írhat az eseménynaplóba. A type egy ikon és egy szöveg jelzi a napló eseménymegtekintő Típus oszlopában.

Note

A message sztring nem tartalmazhat %n értéket, ahol az n egész szám (például %1), mert az eseménynapló beszúrási sztringként kezeli. Mivel az Internet Protocol 6-os (IPv6-) verziója tartalmazhatja ezt a karaktersorozatot, nem naplózhat IPv6-címet tartalmazó eseményüzenetet.

Mielőtt bejegyzéseket írhat a naplóba, be kell állítania a SourceEventLog tulajdonságot az összetevőn. Az első bejegyzés forrással való írása előtt létre kell hoznia és konfigurálnia kell az eseményforrást.

Hozza létre az új eseményforrást az alkalmazás telepítése során. Ez lehetővé teszi, hogy az operációs rendszer frissítse a regisztrált eseményforrások listáját és azok konfigurációját. Ha az operációs rendszer nem frissítette az eseményforrások listáját, és egy eseményt próbál meg írni az új forrással, az írási művelet sikertelen lesz. Új forrást konfigurálhat egy EventLogInstaller, vagy a CreateEventSource metódus használatával. Új eseményforrás létrehozásához rendszergazdai jogosultságokkal kell rendelkeznie a számítógépen.

Ha a példány tulajdonságában SourceEventLog megadott forrás nincs regisztrálva azon a számítógépen, amelyen az összetevő ír, WriteEntry meghívja CreateEventSource és regisztrálja a forrást.

Note

Ha a hívás MachineName előtt nem ad EventLog meg egy példánytCreateEventSource, a WriteEntryrendszer feltételezi a helyi számítógép (".") megadását.

Ha a rendszernek egy híváson Source keresztül kell regisztrálnia, WriteEntry és a Log tulajdonság nincs beállítva a EventLog példányon, a napló alapértelmezés szerint az alkalmazásnaplóba lesz beállítva.

Note

A fent felsorolt kivételek közül számosat a regisztráció során felmerülő hibák okoznak Source.

A forrást honosított bejegyzések írására vagy közvetlen sztringek írására kell konfigurálni. A WriteEntry metódus közvetlenül az eseménynaplóba írja a megadott sztringet, nem használ honosítható üzenet erőforrásfájlt. A metódussal WriteEvent eseményeket írhat egy honosított üzeneterőforrás-fájllal.

Ha az alkalmazás erőforrás-azonosítók és sztringértékek használatával is ír bejegyzéseket, két különálló forrást kell regisztrálnia. Konfiguráljon például egy forrást erőforrásfájlokkal, majd használja ezt a forrást a WriteEvent metódusban bejegyzések írásához erőforrás-azonosítók használatával az eseménynaplóba. Ezután hozzon létre egy másik forrást erőforrásfájlok nélkül, és használja ezt a forrást a WriteEntry metódusban, hogy sztringeket írjon közvetlenül az eseménynaplóba ezzel a forrással.

Note

Ha egy bejegyzést egy távoli számítógépre ír, előfordulhat, hogy az üzenet értéke (a szöveges sztring) nem az, amit vár, ha a távoli számítógép nem a .NET-keretrendszert futtatja.

Note

Ha a message paraméter NUL-karaktert tartalmaz, az eseménynaplóban szereplő üzenet az NUL karakterrel végződik.

Lásd még

A következőre érvényes:

WriteEntry(String, EventLogEntryType, Int32)

Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs

A megadott üzenetszöveggel és alkalmazás által definiált eseményazonosítóval rendelkező bejegyzést ír az eseménynaplóba.

public:
 void WriteEntry(System::String ^ message, System::Diagnostics::EventLogEntryType type, int eventID);
public void WriteEntry(string? message, System.Diagnostics.EventLogEntryType type, int eventID);
public void WriteEntry(string message, System.Diagnostics.EventLogEntryType type, int eventID);
member this.WriteEntry : string * System.Diagnostics.EventLogEntryType * int -> unit
Public Sub WriteEntry (message As String, type As EventLogEntryType, eventID As Integer)

Paraméterek

message
String

Az eseménynaplóba írni kívánt sztring.

type
EventLogEntryType

Az egyik EventLogEntryType érték.

eventID
Int32

Az esemény alkalmazásspecifikus azonosítója.

Kivételek

A Source tulajdonság EventLog nincs beállítva.

-vagy-

A metódus új eseményforrást próbált regisztrálni, de a számítógép neve MachineName érvénytelen.

-vagy-

A forrás már regisztrálva van egy másik eseménynaplóhoz.

-vagy-

eventID kisebb, mint nulla vagy nagyobb, mint az UInt16.MaxValue.

-vagy-

Az üzenetsztring hosszabb, mint 31 839 bájt (Windows operációs rendszereken 32 766 bájt, mielőtt Windows Vista).

-vagy-

A forrásnév 254 karakternél hosszabb beállításkulcs-elérési utat eredményez.

Az eseménynapló beállításkulcsa nem nyitható meg.

Az operációs rendszer hibát jelentett, amikor az eseménybejegyzést az eseménynaplóba írta. Nem érhető el Windows hibakód.

Példák

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

Megjegyzések

Ezzel a módszerrel egy bejegyzést írhat az eseménynaplóba egy alkalmazás által definiált eventID alkalmazással. A eventID forrással együtt egyedileg azonosít egy eseményt. Minden alkalmazás meghatározhatja a saját számozott eseményeit és azokat a leírási sztringeket, amelyekre leképezett. Az eseménymegjelenítők megjelenítik ezeket a sztringértékeket, hogy a felhasználó megértse, mi történt, és javaslatot tegyen a végrehajtandó műveletekre.

Note

A message sztring nem tartalmazhat %n értéket, ahol az n egész szám (például %1), mert az eseménynapló beszúrási sztringként kezeli. Mivel az Internet Protocol 6-os (IPv6-) verziója tartalmazhatja ezt a karaktersorozatot, nem naplózhat IPv6-címet tartalmazó eseményüzenetet.

Az eseményazonosítón kívül megadhatja EventLogEntryType az eseménynaplóba írt eseményt is. A type egy ikon és egy szöveg jelzi a napló eseménymegtekintő Típus oszlopában. Ez a paraméter azt jelzi, hogy az esemény típusa hiba, figyelmeztetés, információ, sikeres naplózás vagy hibanaplózás.

Mielőtt bejegyzéseket írhat a naplóba, be kell állítania a SourceEventLog tulajdonságot az összetevőn. Az első bejegyzés forrással való írása előtt létre kell hoznia és konfigurálnia kell az eseményforrást.

Hozza létre az új eseményforrást az alkalmazás telepítése során. Ez lehetővé teszi, hogy az operációs rendszer frissítse a regisztrált eseményforrások listáját és azok konfigurációját. Ha az operációs rendszer nem frissítette az eseményforrások listáját, és egy eseményt próbál meg írni az új forrással, az írási művelet sikertelen lesz. Új forrást konfigurálhat egy EventLogInstaller, vagy a CreateEventSource metódus használatával. Új eseményforrás létrehozásához rendszergazdai jogosultságokkal kell rendelkeznie a számítógépen.

Ha a példány tulajdonságában SourceEventLog megadott forrás nincs regisztrálva azon a számítógépen, amelyen az összetevő ír, WriteEntry meghívja CreateEventSource és regisztrálja a forrást.

Note

Ha a hívás MachineName előtt nem ad EventLog meg egy példánytCreateEventSource, a WriteEntryrendszer feltételezi a helyi számítógép (".") megadását.

Ha a rendszernek egy híváson Source keresztül kell regisztrálnia, WriteEntry és a Log tulajdonság nincs beállítva a EventLog példányon, a napló alapértelmezés szerint az alkalmazásnaplóba lesz beállítva.

Note

A fent felsorolt kivételek közül számosat a regisztráció során felmerülő hibák okoznak Source.

A forrást honosított bejegyzések írására vagy közvetlen sztringek írására kell konfigurálni. A WriteEntry metódus közvetlenül az eseménynaplóba írja a megadott sztringet, nem használ honosítható üzenet erőforrásfájlt. A metódussal WriteEvent eseményeket írhat egy honosított üzeneterőforrás-fájllal.

Ha az alkalmazás erőforrás-azonosítók és sztringértékek használatával is ír bejegyzéseket, két különálló forrást kell regisztrálnia. Konfiguráljon például egy forrást erőforrásfájlokkal, majd használja ezt a forrást a WriteEvent metódusban bejegyzések írásához erőforrás-azonosítók használatával az eseménynaplóba. Ezután hozzon létre egy másik forrást erőforrásfájlok nélkül, és használja ezt a forrást a WriteEntry metódusban, hogy sztringeket írjon közvetlenül az eseménynaplóba ezzel a forrással.

Note

Ha egy bejegyzést egy távoli számítógépre ír, előfordulhat, hogy az üzenet értéke (a szöveges sztring) nem az, amit vár, ha a távoli számítógép nem a .NET-keretrendszert futtatja.

Note

Ha a message paraméter NUL-karaktert tartalmaz, az eseménynaplóban szereplő üzenet az NUL karakterrel végződik.

Lásd még

A következőre érvényes:

WriteEntry(String, String)

Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs

Egy adattípus-bejegyzést ír az eseménynaplóba a megadott üzenetszöveggel a megadott regisztrált eseményforrás használatával.

public:
 static void WriteEntry(System::String ^ source, System::String ^ message);
public static void WriteEntry(string source, string? message);
public static void WriteEntry(string source, string message);
static member WriteEntry : string * string -> unit
Public Shared Sub WriteEntry (source As String, message As String)

Paraméterek

source
String

Az a forrás, amellyel az alkalmazás regisztrálva van a megadott számítógépen.

message
String

Az eseménynaplóba írni kívánt sztring.

Kivételek

Az source érték egy üres sztring ("").

-vagy-

Az source érték a következő null: .

-vagy-

Az üzenetsztring hosszabb, mint 31 839 bájt (Windows operációs rendszereken 32 766 bájt, mielőtt Windows Vista).

-vagy-

A forrásnév 254 karakternél hosszabb beállításkulcs-elérési utat eredményez.

Az eseménynapló beállításkulcsa nem nyitható meg.

Az operációs rendszer hibát jelentett, amikor az eseménybejegyzést az eseménynaplóba írta. Nem érhető el Windows hibakód.

Példák

Az alábbi példa létrehozza a forrást MySource , ha még nem létezik, és egy bejegyzést ír az eseménynaplóba 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

Megjegyzések

Ezzel a módszerrel adatokat írhat az eseménynaplóba egy olyan forrás használatával, amely már regisztrálva van eseményforrásként a megfelelő naplóhoz. Ha más EventLogEntryTypeértéket szeretne megadni, használjon másik túlterhelést WriteEntry.

Az első bejegyzés forrással való írása előtt létre kell hoznia és konfigurálnia kell az eseményforrást. Hozza létre az új eseményforrást az alkalmazás telepítése során. Ez lehetővé teszi, hogy az operációs rendszer frissítse a regisztrált eseményforrások listáját és azok konfigurációját. Ha az operációs rendszer nem frissítette az eseményforrások listáját, és egy eseményt próbál meg írni az új forrással, az írási művelet sikertelen lesz. Új forrást konfigurálhat egy EventLogInstaller, vagy a CreateEventSource metódus használatával. Új eseményforrás létrehozásához rendszergazdai jogosultságokkal kell rendelkeznie a számítógépen.

A forrást honosított bejegyzések írására vagy közvetlen sztringek írására kell konfigurálni. A WriteEntry metódus közvetlenül az eseménynaplóba írja a megadott sztringet, nem használ honosítható üzenet erőforrásfájlt. A metódussal WriteEvent eseményeket írhat egy honosított üzeneterőforrás-fájllal.

Ha az alkalmazás erőforrás-azonosítók és sztringértékek használatával is ír bejegyzéseket, két különálló forrást kell regisztrálnia. Konfiguráljon például egy forrást erőforrásfájlokkal, majd használja ezt a forrást a WriteEvent metódusban bejegyzések írásához erőforrás-azonosítók használatával az eseménynaplóba. Ezután hozzon létre egy másik forrást erőforrásfájlok nélkül, és használja ezt a forrást a WriteEntry metódusban, hogy sztringeket írjon közvetlenül az eseménynaplóba ezzel a forrással.

Note

Ha a message paraméter NUL-karaktert tartalmaz, az eseménynaplóban szereplő üzenet az NUL karakterrel végződik.

A message sztring nem tartalmazhat %n értéket, ahol az n egész szám (például %1), mert az eseménynapló beszúrási sztringként kezeli. Mivel az Internet Protocol 6-os (IPv6-) verziója tartalmazhatja ezt a karaktersorozatot, nem naplózhat IPv6-címet tartalmazó eseményüzenetet.

Lásd még

A következőre érvényes:

WriteEntry(String)

Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs

Egy adattípus-bejegyzést ír az eseménynaplóba a megadott üzenetszöveggel.

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

Paraméterek

message
String

Az eseménynaplóba írni kívánt sztring.

Kivételek

A Source tulajdonság EventLog nincs beállítva.

-vagy-

A metódus új eseményforrást próbált regisztrálni, de a számítógép neve MachineName érvénytelen.

-vagy-

A forrás már regisztrálva van egy másik eseménynaplóhoz.

-vagy-

Az üzenetsztring hosszabb, mint 31 839 bájt (Windows operációs rendszereken 32 766 bájt, mielőtt Windows Vista).

-vagy-

A forrásnév 254 karakternél hosszabb beállításkulcs-elérési utat eredményez.

Az eseménynapló beállításkulcsa nem nyitható meg.

Az operációs rendszer hibát jelentett, amikor az eseménybejegyzést az eseménynaplóba írta. Nem érhető el Windows hibakód.

Példák

Az alábbi példa létrehozza a forrást MySource , ha még nem létezik, és egy bejegyzést ír az eseménynaplóba 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

Megjegyzések

Ezzel a módszerrel adatbejegyzést írhat a példányhoz társított eseménynaplóba EventLog . Ha más EventLogEntryTypeértéket szeretne megadni, használjon másik túlterhelést WriteEntry.

Note

A message sztring nem tartalmazhat %n értéket, ahol az n egész szám (például %1), mert az eseménynapló beszúrási sztringként kezeli. Mivel az Internet Protocol 6-os (IPv6-) verziója tartalmazhatja ezt a karaktersorozatot, nem naplózhat IPv6-címet tartalmazó eseményüzenetet.

Mielőtt bejegyzéseket írhat a naplóba, be kell állítania a SourceEventLog tulajdonságot az összetevőn. Az első bejegyzés forrással való írása előtt létre kell hoznia és konfigurálnia kell az eseményforrást.

Hozza létre az új eseményforrást az alkalmazás telepítése során. Ez lehetővé teszi, hogy az operációs rendszer frissítse a regisztrált eseményforrások listáját és azok konfigurációját. Ha az operációs rendszer nem frissítette az eseményforrások listáját, és egy eseményt próbál meg írni az új forrással, az írási művelet sikertelen lesz. Új forrást konfigurálhat egy EventLogInstaller, vagy a CreateEventSource metódus használatával. Új eseményforrás létrehozásához rendszergazdai jogosultságokkal kell rendelkeznie a számítógépen.

Ha a példány tulajdonságában SourceEventLog megadott forrás nincs regisztrálva azon a számítógépen, amelyen az összetevő ír, WriteEntry meghívja CreateEventSource és regisztrálja a forrást.

Note

Ha a hívás MachineName előtt nem ad EventLog meg egy példánytCreateEventSource, a WriteEntryrendszer feltételezi a helyi számítógép (".") megadását.

Ha a rendszernek egy híváson Source keresztül kell regisztrálnia, WriteEntry és a Log tulajdonság nincs beállítva a EventLog példányon, a napló alapértelmezés szerint az alkalmazásnaplóba lesz beállítva.

Note

A fent felsorolt kivételek közül számosat a regisztráció során felmerülő hibák okoznak Source.

A forrást honosított bejegyzések írására vagy közvetlen sztringek írására kell konfigurálni. A WriteEntry metódus közvetlenül az eseménynaplóba írja a megadott sztringet, nem használ honosítható üzenet erőforrásfájlt. A metódussal WriteEvent eseményeket írhat egy honosított üzeneterőforrás-fájllal.

Ha az alkalmazás erőforrás-azonosítók és sztringértékek használatával is ír bejegyzéseket, két különálló forrást kell regisztrálnia. Konfiguráljon például egy forrást erőforrásfájlokkal, majd használja ezt a forrást a WriteEvent metódusban bejegyzések írásához erőforrás-azonosítók használatával az eseménynaplóba. Ezután hozzon létre egy másik forrást erőforrásfájlok nélkül, és használja ezt a forrást a WriteEntry metódusban, hogy sztringeket írjon közvetlenül az eseménynaplóba ezzel a forrással.

Note

Ha egy bejegyzést egy távoli számítógépre ír, előfordulhat, hogy az üzenet értéke (a szöveges sztring) nem az, amit vár, ha a távoli számítógép nem a .NET-keretrendszert futtatja.

Note

Ha a message paraméter NUL-karaktert tartalmaz, az eseménynaplóban szereplő üzenet az NUL karakterrel végződik.

Lásd még

A következőre érvényes:

WriteEntry(String, String, EventLogEntryType)

Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs
Forrás:
EventLog.cs

A megadott regisztrált eseményforrás használatával hibaüzenetet, figyelmeztetést, információt, sikeres naplózást vagy hibanapló-bejegyzést ír az eseménynaplóba a megadott üzenetszöveggel.

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);
public static void WriteEntry(string source, string message, System.Diagnostics.EventLogEntryType type);
static member WriteEntry : string * string * System.Diagnostics.EventLogEntryType -> unit
Public Shared Sub WriteEntry (source As String, message As String, type As EventLogEntryType)

Paraméterek

source
String

Az a forrás, amellyel az alkalmazás regisztrálva van a megadott számítógépen.

message
String

Az eseménynaplóba írni kívánt sztring.

type
EventLogEntryType

Az egyik EventLogEntryType érték.

Kivételek

Az source érték egy üres sztring ("").

-vagy-

Az source érték a következő null: .

-vagy-

Az üzenetsztring hosszabb, mint 31 839 bájt (Windows operációs rendszereken 32 766 bájt, mielőtt Windows Vista).

-vagy-

A forrásnév 254 karakternél hosszabb beállításkulcs-elérési utat eredményez.

Az eseménynapló beállításkulcsa nem nyitható meg.

Az operációs rendszer hibát jelentett, amikor az eseménybejegyzést az eseménynaplóba írta. Nem érhető el Windows hibakód.

Példák

Az alábbi példa egy figyelmeztető bejegyzést ír a helyi számítógépen található "MyNewLog" eseménynaplóba.

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

Megjegyzések

Ezzel a módszerrel egy megadott EventLogEntryType bejegyzést írhat az eseménynaplóba egy olyan forrás használatával, amely már regisztrálva van eseményforrásként a megfelelő naplóhoz. A type egy ikon és egy szöveg jelzi a napló eseménymegtekintő Típus oszlopában.

Note

A message sztring nem tartalmazhat %n értéket, ahol az n egész szám (például %1), mert az eseménynapló beszúrási sztringként kezeli. Mivel az Internet Protocol 6-os (IPv6-) verziója tartalmazhatja ezt a karaktersorozatot, nem naplózhat IPv6-címet tartalmazó eseményüzenetet.

Az első bejegyzés forrással való írása előtt létre kell hoznia és konfigurálnia kell az eseményforrást. Hozza létre az új eseményforrást az alkalmazás telepítése során. Ez lehetővé teszi, hogy az operációs rendszer frissítse a regisztrált eseményforrások listáját és azok konfigurációját. Ha az operációs rendszer nem frissítette az eseményforrások listáját, és egy eseményt próbál meg írni az új forrással, az írási művelet sikertelen lesz. Új forrást konfigurálhat egy EventLogInstaller, vagy a CreateEventSource metódus használatával. Új eseményforrás létrehozásához rendszergazdai jogosultságokkal kell rendelkeznie a számítógépen.

A forrást honosított bejegyzések írására vagy közvetlen sztringek írására kell konfigurálni. A WriteEntry metódus közvetlenül az eseménynaplóba írja a megadott sztringet, nem használ honosítható üzenet erőforrásfájlt. A metódussal WriteEvent eseményeket írhat egy honosított üzeneterőforrás-fájllal.

Ha az alkalmazás erőforrás-azonosítók és sztringértékek használatával is ír bejegyzéseket, két különálló forrást kell regisztrálnia. Konfiguráljon például egy forrást erőforrásfájlokkal, majd használja ezt a forrást a WriteEvent metódusban bejegyzések írásához erőforrás-azonosítók használatával az eseménynaplóba. Ezután hozzon létre egy másik forrást erőforrásfájlok nélkül, és használja ezt a forrást a WriteEntry metódusban, hogy sztringeket írjon közvetlenül az eseménynaplóba ezzel a forrással.

Note

Ha a message paraméter NUL-karaktert tartalmaz, az eseménynaplóban szereplő üzenet az NUL karakterrel végződik.

Lásd még

A következőre érvényes: