EventLogEntry.InstanceId Свойство

Определение

Пространство имен:

System.Diagnostics

Сборка:

System.Diagnostics.EventLog.dll

Исходный код:

EventLogEntry.cs

Возвращает идентификатор ресурса, указывающий текст сообщения записи события.

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

public long InstanceId { get; }

member this.InstanceId : int64

Public ReadOnly Property InstanceId As Long

Значение свойства

Int64

Идентификатор ресурса, соответствующий определению строки в файле ресурса сообщения источника события.

Примеры

В следующем примере кода выполняется поиск журнала событий для записей с определенным идентификатором ресурса. В примере кода отображается сообщение о событии для каждой соответствующей записи и количество соответствующих записей в журнале. Текст сообщения для каждой записи может совпадать или не совпадать; каждое сообщение события зависит от файла исходного сообщения события, строк вставки и параметров, используемых при написании.

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

Комментарии

Свойство InstanceId однозначно идентифицирует запись события для настроенного источника событий. Запись InstanceId журнала событий представляет полный 32-разрядный идентификатор ресурса события в файле ресурса сообщения для источника событий. Свойство EventID равно InstanceId верхнему двум битам, замаскированных. Две записи журнала событий из одного источника могут иметь соответствующие EventID значения, но имеют разные значения из-за различий InstanceId в двух верхних битах идентификатора ресурса.

Если приложение написало запись события с помощью одного из WriteEntry методов, InstanceId свойство соответствует необязательному eventId параметру. Если приложение написало событие с помощью WriteEvent, InstanceId свойство соответствует идентификатору ресурса, указанному в InstanceId параметре instance . Если приложение написало событие с помощью API ReportEventWindows, свойство соответствует идентификатору ресурса, InstanceId указанному в параметре dwEventID .

Дополнительные сведения об определении сообщений о событиях и создании файлов ресурсов журнала событий см. в статье компилятора сообщений в документации по пакету SDK для платформы. Дополнительные сведения об идентификаторах журнала событий см. в статье " Идентификаторы событий " в документации по пакету SDK для платформы.

См. также раздел

• InstanceId
• WriteEvent