EventLogEntry.InstanceId Özellik

Tanım

Ad Alanı:

System.Diagnostics

Bütünleştirilmiş Kod:

System.Diagnostics.EventLog.dll

Paket:

System.Diagnostics.EventLog v8.0.0

Kaynak:

EventLogEntry.cs

Olay girişinin ileti metnini belirten kaynak tanımlayıcısını alır.

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

public long InstanceId { get; }

member this.InstanceId : int64

Public ReadOnly Property InstanceId As Long

Özellik Değeri

Int64

Olay kaynağının ileti kaynak dosyasındaki dize tanımına karşılık gelen kaynak tanımlayıcısı.

Örnekler

Aşağıdaki kod örneği, belirli bir kaynak tanımlayıcısı olan girdiler için bir olay günlüğünde arama yapar. Kod örneği, eşleşen her giriş için olay iletisini görüntüler ve günlükteki eşleşen girdilerin toplam sayısını sayar. Her girdinin ileti metni aynı olabilir veya olmayabilir; her olay iletisi, olay kaynağı ileti dosyasına, ekleme dizelerine ve yazılırken kullanılan parametrelere bağlıdır.

// 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 = gcnew EventLog( myLogName,"." );
int count = 0;
Console::WriteLine( "Searching event log entries for the event ID {0}...", ServerConnectionDownMsgId );

// Search for the resource ID, display the event text,
// and display the number of matching entries.
System::Collections::IEnumerator^ myEnum = myEventLog->Entries->GetEnumerator();
while ( myEnum->MoveNext() )
{
   EventLogEntry^ entry = safe_cast<EventLogEntry^>(myEnum->Current);
   if ( entry->InstanceId == ServerConnectionDownMsgId )
   {
      count++;
      Console::WriteLine();
      Console::WriteLine( "Entry ID    = {0}", entry->InstanceId );
      Console::WriteLine( "Reported at {0}", entry->TimeWritten );
      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, ServerConnectionDownMsgId, myLogName );

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

Açıklamalar

özelliği, InstanceId yapılandırılmış bir olay kaynağı için bir olay girdisini benzersiz olarak tanımlar. InstanceId Olay günlüğü için girdisi, olay kaynağının ileti kaynak dosyasındaki olayın tam 32 bit kaynak tanımlayıcısını temsil eder. özelliği, EventID ilk iki bitin maskelenmiş olduğu değerine eşittir InstanceId . Aynı kaynaktan gelen iki olay günlüğü girdisi eşleşen EventID değerlere sahip olabilir, ancak kaynak tanımlayıcısının ilk iki bitindeki farklılıklar nedeniyle farklı InstanceId değerlere sahip olabilir.

Uygulama yöntemlerden birini kullanarak olay girdisini WriteEntry yazdıysa, InstanceId özelliği isteğe bağlı eventId parametreyle eşleşir. Uygulama kullanarak WriteEventInstanceId olayı yazdıysa, özelliği parametresinde InstanceId belirtilen kaynak tanımlayıcısı ile instance eşleşir. Uygulama Windows API'sini ReportEventInstanceId kullanarak olayı yazdıysa, özelliği parametresinde belirtilen kaynak tanımlayıcısı ile dwEventID eşleşir.

Olay iletilerini tanımlama ve olay günlüğü kaynak dosyaları oluşturma hakkında ayrıntılı bilgi için Platform SDK belgelerindeki İleti Derleyicisi makalesine bakın. Olay günlüğü tanımlayıcıları hakkında ayrıntılı bilgi için Platform SDK belgelerindeki Olay Tanımlayıcıları makalesine bakın.

Ayrıca bkz.

• InstanceId
• WriteEvent