EventLogEntry.InstanceId Properti

Definisi

Ruang nama:

System.Diagnostics

Rakitan:

System.Diagnostics.EventLog.dll

Paket:

System.Diagnostics.EventLog v8.0.0

Sumber:

EventLogEntry.cs

Mendapatkan pengidentifikasi sumber daya yang menunjuk teks pesan dari entri peristiwa.

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

public long InstanceId { get; }

member this.InstanceId : int64

Public ReadOnly Property InstanceId As Long

Nilai Properti

Int64

Pengidentifikasi sumber daya yang sesuai dengan definisi string dalam file sumber daya pesan dari sumber peristiwa.

Contoh

Contoh kode berikut mencari log peristiwa untuk entri dengan pengidentifikasi sumber daya tertentu. Contoh kode menampilkan pesan peristiwa untuk setiap entri yang cocok, dan menghitung jumlah total entri yang cocok dalam log. Teks pesan untuk setiap entri mungkin atau mungkin tidak sama; setiap pesan peristiwa bergantung pada file pesan sumber peristiwa, string penyisipan, dan parameter yang digunakan saat ditulis.

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

Keterangan

Properti InstanceId secara unik mengidentifikasi entri peristiwa untuk sumber peristiwa yang dikonfigurasi. InstanceId untuk entri log peristiwa mewakili pengidentifikasi sumber daya 32-bit lengkap untuk peristiwa dalam file sumber daya pesan untuk sumber peristiwa. Properti EventID sama InstanceId dengan dengan dua bit teratas yang ditutupi. Dua entri log peristiwa dari sumber yang sama dapat memiliki nilai yang cocok EventID , tetapi memiliki nilai yang berbeda InstanceId karena perbedaan dalam dua bit teratas pengidentifikasi sumber daya.

Jika aplikasi menulis entri peristiwa menggunakan salah WriteEntry satu metode, InstanceId properti cocok dengan parameter opsional eventId . Jika aplikasi menulis peristiwa menggunakan WriteEvent, InstanceId properti cocok dengan pengidentifikasi sumber daya yang ditentukan dalam InstanceIdinstance parameter . Jika aplikasi menulis peristiwa menggunakan Windows API ReportEvent, InstanceId properti cocok dengan pengidentifikasi sumber daya yang ditentukan dalam dwEventID parameter .

Untuk detail tentang menentukan pesan peristiwa dan membangun file sumber daya log peristiwa, lihat artikel Pengkompilasi Pesan di dokumentasi Platform SDK. Untuk detail tentang pengidentifikasi log peristiwa, lihat artikel Pengidentifikasi Peristiwa di dokumentasi Platform SDK.

Lihat juga

• InstanceId
• WriteEvent