EventLogEntry.InstanceId Tulajdonság

Definíció

Névtér:

System.Diagnostics

Szerelvény:

System.Diagnostics.EventLog.dll

Csomag:

System.Diagnostics.EventLog v11.0.0-preview.7.26381.103

Forrás:

EventLogEntry.cs

Lekéri az eseménybejegyzés üzenetszövegét meghatározó erőforrás-azonosítót.

public:
 property long InstanceId { long get(); };

public long InstanceId { get; }

member this.InstanceId : int64

Public ReadOnly Property InstanceId As Long

Tulajdonság értéke

Int64

Az eseményforrás üzenet-erőforrásfájljában található sztringdefiníciónak megfelelő erőforrás-azonosító.

Példák

Az alábbi példakód egy eseménynaplóban keres egy adott erőforrás-azonosítóval rendelkező bejegyzéseket. A példakód megjeleníti az egyes egyező bejegyzések eseményüzenetét, és megszámolja a naplóban szereplő egyező bejegyzések teljes számát. Az egyes bejegyzések üzenetszövege lehet, hogy nem azonos; az egyes eseményüzenetek az eseményforrás üzenetfájljától, a beszúrási sztringtől és a megíráskor használt paraméterektől függnek.

// Get the event log corresponding to the existing source.
string myLogName = EventLog.LogNameFromSourceName(sourceName,".");

// Find each instance of a specific event log entry in a
// particular event log.

EventLog myEventLog = new EventLog(myLogName, ".");
int count = 0;

Console.WriteLine("Searching event log entries for the event ID {0}...",
    ServerConnectionDownMsgId.ToString());

// Search for the resource ID, display the event text,
// and display the number of matching entries.

foreach(EventLogEntry entry in myEventLog.Entries)
{
    if (entry.InstanceId == ServerConnectionDownMsgId)
    {
        count ++;
        Console.WriteLine();
        Console.WriteLine("Entry ID    = {0}",
            entry.InstanceId.ToString());
        Console.WriteLine("Reported at {0}",
            entry.TimeWritten.ToString());
        Console.WriteLine("Message text:");
        Console.WriteLine("\t{0}", entry.Message);
    }
}
Console.WriteLine();
Console.WriteLine("Found {0} events with ID {1} in event log {2}.",
    count.ToString(), ServerConnectionDownMsgId.ToString(), myLogName);

    ' Get the event log corresponding to the existing source.
    Dim myLogName As String = EventLog.LogNameFromSourceName(sourceName,".")

    ' Find each instance of a specific event log entry in a
    ' particular event log.

    Dim myEventLog As EventLog = new EventLog(myLogName, ".", sourceName)
    Dim count As Integer = 0

    Console.WriteLine("Searching event log entries for the event ID {0}...", _
       ServerConnectionDownMsgId.ToString())
    
    ' Search for the resource ID, display the event text,
    ' and display the number of matching entries.

    Dim entry As EventLogEntry
    For Each entry In  myEventLog.Entries
        If entry.InstanceId = ServerConnectionDownMsgId
            count = count + 1
            Console.WriteLine()
            Console.WriteLine("Entry ID    = {0}", _
                entry.InstanceId.ToString())
            Console.WriteLine("Reported at {0}", _
                entry.TimeWritten.ToString())
            Console.WriteLine("Message text:")
            Console.WriteLine(ControlChars.Tab + entry.Message)
        End If
    Next entry

    Console.WriteLine()
    Console.WriteLine("Found {0} events with ID {1} in event log {2}", _
        count.ToString(), ServerConnectionDownMsgId.ToString(), myLogName)

Megjegyzések

A InstanceId tulajdonság egyedileg azonosítja a konfigurált eseményforrás eseménybejegyzését. Az InstanceId eseménynapló bejegyzése az esemény teljes 32 bites erőforrás-azonosítóját jelöli az esemény forrásának üzeneterőforrás-fájljában. A EventID tulajdonság egyenlő az InstanceId első két bit maszkolásával. Az azonos forrásból származó két eseménynapló-bejegyzésnek lehetnek egyező EventID értékei, de az erőforrás-azonosító első két bitjének eltérései miatt eltérőek InstanceId az értékek.

Ha az alkalmazás az egyik metódussal írta az WriteEntry eseménybejegyzést, a InstanceId tulajdonság megfelel az opcionális paraméternek eventId . Ha az alkalmazás az eseményt használja WriteEvent, a InstanceId tulajdonság megegyezik a InstanceIdinstance paraméterben megadott erőforrás-azonosítóval. Ha az alkalmazás az Windows API ReportEvent használatával írta az eseményt, a InstanceId tulajdonság megegyezik a dwEventID paraméterben megadott erőforrás-azonosítóval.

Az eseményüzenetek meghatározásával és az eseménynapló-erőforrásfájlok létrehozásával kapcsolatos részletekért tekintse meg a Platform SDK dokumentációjában található Üzenetfordító cikket. Az eseménynapló-azonosítókkal kapcsolatos részletekért tekintse meg a Platform SDK dokumentációjában található Eseményazonosítók cikket.

Lásd még

• InstanceId
• WriteEvent