EventLogEntry.InstanceId Propriedade

Definição

Espaço de Nomes:
System.Diagnostics
Assemblagem:
System.dll

Obtém o identificador de recurso que designa o texto da mensagem da entrada do evento.

public:
 property long InstanceId { long get(); };
[System.Runtime.InteropServices.ComVisible(false)]
public long InstanceId { get; }
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.InstanceId : int64
Public ReadOnly Property InstanceId As Long

Valor de Propriedade

Int64

Um identificador de recurso que corresponde a uma definição de cadeia no ficheiro de recurso da mensagem da fonte do evento.

Atributos
ComVisibleAttribute

Exemplos

O exemplo de código seguinte pesquisa num registo de eventos por entradas com um identificador de recurso específico. O exemplo de código mostra a mensagem do evento para cada entrada correspondente e conta o número total de entradas correspondentes no registo. O texto da mensagem para cada entrada pode ou não ser o mesmo; Cada mensagem de evento depende do ficheiro de mensagem de origem do evento, das strings de inserção e dos parâmetros usados quando foi escrita.

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

Observações

A InstanceId propriedade identifica de forma única uma entrada de evento para uma fonte de evento configurada. O InstanceId para uma entrada no registo de eventos representa o identificador completo de recurso de 32 bits para o evento no ficheiro de recurso da mensagem da fonte do evento. A EventID propriedade é igual a InstanceId com os dois bits superiores mascarados. Duas entradas do registo de eventos da mesma fonte podem ter valores correspondentes EventID , mas valores diferentes InstanceId devido a diferenças nos dois bits superiores do identificador de recurso.

Se a aplicação escreveu a entrada do evento usando um dos WriteEntry métodos, a InstanceId propriedade corresponde ao parâmetro opcional eventId . Se a aplicação escreveu o evento usando WriteEvent, a InstanceId propriedade corresponde ao identificador de recurso especificado no InstanceId do instance parâmetro. Se a aplicação escreveu o evento usando a API Windows ReportEvent, a propriedade InstanceId corresponde ao identificador de recurso especificado no parâmetro dwEventID.

Para detalhes sobre a definição de mensagens de eventos e a construção de ficheiros de recursos do registo de eventos, consulte o artigo do Compilador de Mensagens na documentação do SDK da Plataforma. Para detalhes sobre identificadores de registo de eventos, consulte o artigo sobre Identificadores de Eventos na documentação do SDK da Plataforma.

Aplica-se a

Ver também