EventLogEntry.InstanceId Propiedad

Definición

Espacio de nombres:

System.Diagnostics

Ensamblado:

System.Diagnostics.EventLog.dll

Paquete:

System.Diagnostics.EventLog v8.0.0

Source:

EventLogEntry.cs

Obtiene el identificador de recursos que designa el texto del mensaje de la entrada de eventos.

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

public long InstanceId { get; }

member this.InstanceId : int64

Public ReadOnly Property InstanceId As Long

Valor de propiedad

Int64

Identificador de recursos correspondiente a una definición de cadena del archivo de recursos de mensajes del origen de eventos.

Ejemplos

En el ejemplo de código siguiente se busca un registro de eventos para las entradas con un identificador de recurso determinado. En el ejemplo de código se muestra el mensaje de evento para cada entrada coincidente y se cuenta el número total de entradas coincidentes en el registro. El texto del mensaje para cada entrada puede o no ser el mismo; cada mensaje de evento depende del archivo de mensaje de origen del evento, las cadenas de inserción y los parámetros usados cuando se escribió.

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

Comentarios

La InstanceId propiedad identifica de forma única una entrada de evento para un origen de eventos configurado. para InstanceId una entrada del registro de eventos representa el identificador de recursos completo de 32 bits para el evento en el archivo de recursos del mensaje para el origen del evento. La EventID propiedad es igual a InstanceId con los dos bits superiores enmascarados. Dos entradas del registro de eventos del mismo origen pueden tener valores coincidentes EventID , pero tienen valores diferentes InstanceId debido a diferencias en los dos bits principales del identificador de recursos.

Si la aplicación escribió la entrada de evento mediante uno de los WriteEntry métodos , la InstanceId propiedad coincide con el parámetro opcional eventId . Si la aplicación escribió el evento mediante WriteEvent, la InstanceId propiedad coincide con el identificador de recurso especificado en del instanceInstanceId parámetro . Si la aplicación escribió el evento mediante la API ReportEventde Windows, la InstanceId propiedad coincide con el identificador de recurso especificado en el dwEventID parámetro .

Para más información sobre cómo definir mensajes de eventos y compilar archivos de recursos de registro de eventos, consulte el artículo Del compilador de mensajes en la documentación del SDK de plataforma. Para más información sobre los identificadores de registro de eventos, consulte el artículo Identificadores de eventos en la documentación del SDK de plataforma.

Consulte también

• InstanceId
• WriteEvent