¿Le resultó útil esta página?
Sus comentarios sobre este contenido son muy importantes. Háganos saber su opinión.
¿Tiene comentarios adicionales?
Caracteres restantes: 1500
Exportar (0) Imprimir
Expandir todo

EventLogEntry.InstanceId (Propiedad)

Actualización: noviembre 2007

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

Espacio de nombres:  System.Diagnostics
Ensamblado:  System (en System.dll)

[ComVisibleAttribute(false)]
public long InstanceId { get; }
/** @property */
/** @attribute ComVisibleAttribute(false) */
public long get_InstanceId()

public function get InstanceId () : long

Valor de propiedad

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

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

Si la aplicación escribió la entrada de evento utilizando uno de los métodos WriteEntry, la propiedad InstanceId coincide con el parámetro eventId opcional. Si la aplicación escribió el evento mediante WriteEvent, la propiedad InstanceId coincide con el identificador de recursos especificado en la propiedad InstanceId del parámetro instance. Si la aplicación escribió el evento mediante ReportEvent API Win32, la propiedad InstanceId coincide con el identificador de recursos especificado en el parámetro dwEventID.

Para obtener información detallada acerca de la definición de mensajes de evento y la generación de archivos de recursos de registro de eventos, vea el tema "Compilador de mensajes" en la documentación de Platform SDK en http://msdn2.microsoft.com/es-es/default.aspx. Para obtener información detallada sobre la definición de categorías de evento en archivos de recursos, vea el tema sobre categorías de evento en Platform SDK.

En el siguiente ejemplo de código se buscan entradas con un identificador de recursos determinado en un registro de eventos. En el ejemplo de código se muestra el mensaje de evento de cada entrada coincidente y se cuenta el número total de entradas coincidentes del registro. El texto del mensaje de cada entrada puede o no ser el mismo; cada mensaje de evento depende del archivo de mensaje del origen de eventos, las cadenas de inserción y los parámetros utilizados 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 = 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);



Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft