EventLogEntry.InstanceId Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém o identificador de recurso que designa o texto da mensagem da entrada do evento.
public:
property long InstanceId { long get(); };
public long InstanceId { get; }
[System.Runtime.InteropServices.ComVisible(false)]
public long InstanceId { get; }
member this.InstanceId : int64
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.InstanceId : int64
Public ReadOnly Property InstanceId As Long
Valor da propriedade
Um identificador de recurso que corresponde a uma definição de cadeia de caracteres no arquivo de recurso de mensagem da fonte do evento.
- Atributos
Exemplos
O exemplo de código a seguir pesquisa entradas em um log de eventos com um identificador de recurso específico. O exemplo de código exibe a mensagem de evento para cada entrada correspondente e conta o número total de entradas correspondentes no log. O texto da mensagem para cada entrada pode ou não ser o mesmo; cada mensagem de evento depende do arquivo de mensagem de origem do evento, cadeias de caracteres de inserção e parâmetros usados quando ele foi gravado.
// 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)
Comentários
A InstanceId propriedade identifica exclusivamente uma entrada de evento para uma fonte de evento configurada. O InstanceId para uma entrada de log de eventos representa o identificador de recurso completo de 32 bits para o evento no arquivo de recurso de mensagem da origem do evento. A EventID propriedade é igual à InstanceId com os dois principais bits mascarados. Duas entradas de log de eventos da mesma origem podem ter valores correspondentes EventID , mas têm valores diferentes InstanceId devido a diferenças nos dois principais bits do identificador de recurso.
Se o aplicativo tiver escrito a entrada de evento usando um dos WriteEntry métodos, a InstanceId propriedade corresponderá ao parâmetro opcional eventId
. Se o aplicativo tiver escrito o evento usando WriteEvent, a InstanceId propriedade corresponderá ao identificador de recurso especificado no InstanceId do instance
parâmetro . Se o aplicativo tiver escrito o evento usando a API ReportEvent
do Windows, a InstanceId propriedade corresponderá ao identificador de recurso especificado no dwEventID
parâmetro .
Para obter detalhes sobre como definir mensagens de evento e criar arquivos de recursos de log de eventos, consulte o artigo Compilador de Mensagens na documentação do SDK da Plataforma. Para obter detalhes sobre identificadores de log de eventos, consulte o artigo Identificadores de Eventos na documentação do SDK da Plataforma.