EventInstance Konstruktoren

Definition

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.EventLog.dll

Paket:

System.Diagnostics.EventLog v8.0.0

Initialisiert mithilfe sprachneutraler Informationen zum Definieren eines Ereignisprotokolleintrags eine neue Instanz der EventInstance-Klasse.

Überlädt

EventInstance(Int64, Int32)	Initialisiert mithilfe der angegebenen Ressourcenbezeichner für die lokalisierte Meldung und des Kategorietexts des Ereigniseintrags eine neue Instanz der EventInstance-Klasse.
EventInstance(Int64, Int32, EventLogEntryType)	Initialisiert mithilfe der angegebenen Ressourcenbezeichner für die lokalisierte Meldung und des Kategorietexts des Ereigniseintrags sowie des angegebenen Typs des Ereignisprotokolleintrags eine neue Instanz der EventInstance-Klasse.

EventInstance(Int64, Int32)

Quelle:

EventData.cs

Initialisiert mithilfe der angegebenen Ressourcenbezeichner für die lokalisierte Meldung und des Kategorietexts des Ereigniseintrags eine neue Instanz der EventInstance-Klasse.

public:
 EventInstance(long instanceId, int categoryId);

public EventInstance (long instanceId, int categoryId);

new System.Diagnostics.EventInstance : int64 * int -> System.Diagnostics.EventInstance

Public Sub New (instanceId As Long, categoryId As Integer)

Parameter

instanceId

Int64

Ein Ressourcenbezeichner, der mit einer in der Meldungsressourcendatei der Ereignisquelle definierten Zeichenfolge übereinstimmt.

categoryId

Int32

Ein Ressourcenbezeichner, der mit einer in der Kategorieressourcendatei der Ereignisquelle definierten Zeichenfolge übereinstimmt oder gleich 0 (null) ist und damit keine Kategorie für das Ereignis spezifiziert.

Ausnahmen

ArgumentOutOfRangeException

Der instanceId Parameter ist ein negativer Wert oder ein Wert, der größer als UInt32.MaxValue ist.

Oder

Der categoryId Parameter ist ein negativer Wert oder ein Wert, der größer als UInt16.MaxValue ist.

Beispiele

Im folgenden Codebeispiel wird ein Informationsereigniseintrag geschrieben und dann wiederverwendet EventInstance , um einen Eintrag für ein Warnereignis in ein vorhandenes Ereignisprotokoll zu schreiben. Der Ereignisnachrichtentext wird mithilfe eines Ressourcenbezeichners in einer Nachrichtenressourcendatei angegeben. Im Codebeispiel wird davon ausgegangen, dass die entsprechende Nachrichtenressourcendatei für die Quelle registriert wurde.

// Ensure that the source has already been registered using
// EventLogInstaller or EventLog.CreateEventSource.
String^ sourceName = "SampleApplicationSource";
if ( EventLog::SourceExists( sourceName ) )
{
   // Define an informational event with no category.
   // The message identifier corresponds to the message text in the
   // message resource file defined for the source.
   EventInstance ^ myEvent = gcnew EventInstance( UpdateCycleCompleteMsgId,0 );

   // Write the event to the event log using the registered source.
   EventLog::WriteEvent( sourceName, myEvent, 0 );

   // Reuse the event data instance for another event entry.
   // Set the entry category and message identifiers for
   // the appropriate resource identifiers in the resource files
   // for the registered source.  Set the event type to Warning.
   myEvent->CategoryId = RefreshCategoryMsgId;
   myEvent->EntryType = EventLogEntryType::Warning;
   myEvent->InstanceId = ServerConnectionDownMsgId;

   // Write the event to the event log using the registered source.
   // Insert the machine name into the event message text.
   array<String^>^ss = {Environment::MachineName};
   EventLog::WriteEvent( sourceName, myEvent, ss );
}
else
{
   Console::WriteLine( "Warning - event source {0} not registered", sourceName );
}

// Ensure that the source has already been registered using
// EventLogInstaller or EventLog.CreateEventSource.

string sourceName = "SampleApplicationSource";
if(EventLog.SourceExists(sourceName))
{
    // Define an informational event with no category.
    // The message identifier corresponds to the message text in the
    // message resource file defined for the source.
    EventInstance myEvent = new EventInstance(UpdateCycleCompleteMsgId, 0);

    // Write the event to the event log using the registered source.
    EventLog.WriteEvent(sourceName, myEvent);

    // Reuse the event data instance for another event entry.
    // Set the entry category and message identifiers for
    // the appropriate resource identifiers in the resource files
    // for the registered source.  Set the event type to Warning.

    myEvent.CategoryId = RefreshCategoryMsgId;
    myEvent.EntryType = EventLogEntryType.Warning;
    myEvent.InstanceId = ServerConnectionDownMsgId;

    // Write the event to the event log using the registered source.
    // Insert the machine name into the event message text.
    EventLog.WriteEvent(sourceName, myEvent, Environment.MachineName);
}
else
{
    Console.WriteLine("Warning - event source {0} not registered",
        sourceName);
}

' Ensure that the source has already been registered using
' EventLogInstaller or EventLog.CreateEventSource.
Dim sourceName as String = "SampleApplicationSource"
If EventLog.SourceExists(sourceName)
    
    ' Define an informational event with no category.
    ' The message identifier corresponds to the message text in the
    ' message resource file defined for the source.
    Dim myEvent As EventInstance = New EventInstance(UpdateCycleCompleteMsgId, 0)
    ' Write the event to the event log using the registered source.
    EventLog.WriteEvent(sourceName, myEvent)

    ' Reuse the event data instance for another event entry.
    ' Set the entry category and message identifiers for
    ' the appropriate resource identifiers in the resource files
    ' for the registered source.  Set the event type to Warning.

    myEvent.CategoryId = RefreshCategoryMsgId
    myEvent.EntryType = EventLogEntryType.Warning
    myEvent.InstanceId = ServerConnectionDownMsgId

    ' Write the event to the event log using the registered source.
    ' Insert the machine name into the event message text.
    EventLog.WriteEvent(sourceName, myEvent, Environment.MachineName)

Else 
    Console.WriteLine("Warning - event source {0} not registered", _
        sourceName)
End If

Im Codebeispiel wird die folgende Meldungstextdatei verwendet, die in die Ressourcenbibliothek EventLogMsgs.dll integriert ist. Eine Nachrichtentextdatei ist die Quelle, aus der die Nachrichtenressourcendatei erstellt wird. Die Nachrichtentextdatei definiert die Ressourcenbezeichner und den Text für die Kategorie, die Ereignismeldung und die Parametereinfügungszeichenfolgen.

; // EventLogMsgs.mc  
; // ********************************************************  

; // Use the following commands to build this file:  

; //   mc -s EventLogMsgs.mc  
; //   rc EventLogMsgs.rc  
; //   link /DLL /SUBSYSTEM:WINDOWS /NOENTRY /MACHINE:x86 EventLogMsgs.Res   
; // ********************************************************  

; // - Event categories -  
; // Categories must be numbered consecutively starting at 1.  
; // ********************************************************  

MessageId=0x1  
Severity=Success  
SymbolicName=INSTALL_CATEGORY  
Language=English  
Installation  
.  

MessageId=0x2  
Severity=Success  
SymbolicName=QUERY_CATEGORY  
Language=English  
Database Query  
.  

MessageId=0x3  
Severity=Success  
SymbolicName=REFRESH_CATEGORY  
Language=English  
Data Refresh  
.  

; // - Event messages -  
; // *********************************  

MessageId = 1000  
Severity = Success  
Facility = Application  
SymbolicName = AUDIT_SUCCESS_MESSAGE_ID_1000  
Language=English  
My application message text, in English, for message id 1000, called from %1.  
.  

MessageId = 1001  
Severity = Warning  
Facility = Application  
SymbolicName = AUDIT_FAILED_MESSAGE_ID_1001  
Language=English  
My application message text, in English, for message id 1001, called from %1.  
.  

MessageId = 1002  
Severity = Success  
Facility = Application  
SymbolicName = GENERIC_INFO_MESSAGE_ID_1002  
Language=English  
My generic information message in English, for message id 1002.  
.  

MessageId = 1003  
Severity = Warning  
Facility = Application  
SymbolicName = GENERIC_WARNING_MESSAGE_ID_1003  
Language=English  
My generic warning message in English, for message id 1003, called from %1.  
.  

MessageId = 1004  
Severity = Success  
Facility = Application  
SymbolicName = UPDATE_CYCLE_COMPLETE_MESSAGE_ID_1004  
Language=English  
The update cycle is complete for %%5002.  
.  

MessageId = 1005  
Severity = Warning  
Facility = Application  
SymbolicName = SERVER_CONNECTION_DOWN_MESSAGE_ID_1005  
Language=English  
The refresh operation did not complete because the connection to server %1 could not be established.  
.  

; // - Event log display name -  
; // ********************************************************  

MessageId = 5001  
Severity = Success  
Facility = Application  
SymbolicName = EVENT_LOG_DISPLAY_NAME_MSGID  
Language=English  
Sample Event Log  
.  

; // - Event message parameters -  
; //   Language independent insertion strings  
; // ********************************************************  

MessageId = 5002  
Severity = Success  
Facility = Application  
SymbolicName = EVENT_LOG_SERVICE_NAME_MSGID  
Language=English  
SVC_UPDATE.EXE  
.  

Hinweise

Um einen Informationseintrag in ein Ereignisprotokoll zu schreiben, initialisieren Sie einen EventInstance , und übergeben Sie ihn an die WriteEvent -Methode. Legen Sie auf instanceId den Ressourcenbezeichner der Ereignismeldung in der entsprechenden MessageResourceFile Eigenschaft für die Quelle fest. Legen Sie den categoryId auf einen numerischen Kategoriewert oder den Ressourcenbezeichner der Ereigniskategorie in der CategoryResourceFile -Eigenschaft für die Quelle fest. Legen Sie für keine Ereigniskategorie auf categoryId Null fest. Die EntryType -Eigenschaft für die neue instance ist standardmäßig auf Information festgelegt.

Die Ereignisanzeige verwendet die Ressourcenbezeichner, um die entsprechenden Zeichenfolgen aus den lokalisierten Ressourcendateien für die Quelle anzuzeigen. Sie müssen die Quelle bei den entsprechenden Ressourcendateien registrieren, bevor Sie Ereignisse mithilfe von Ressourcenbezeichnern schreiben können.

Weitere Informationen

• CategoryId
• InstanceId
• WriteEvent
• EventSourceCreationData

EventInstance(Int64, Int32, EventLogEntryType)

Quelle:

EventData.cs

Initialisiert mithilfe der angegebenen Ressourcenbezeichner für die lokalisierte Meldung und des Kategorietexts des Ereigniseintrags sowie des angegebenen Typs des Ereignisprotokolleintrags eine neue Instanz der EventInstance-Klasse.

public:
 EventInstance(long instanceId, int categoryId, System::Diagnostics::EventLogEntryType entryType);

public EventInstance (long instanceId, int categoryId, System.Diagnostics.EventLogEntryType entryType);

new System.Diagnostics.EventInstance : int64 * int * System.Diagnostics.EventLogEntryType -> System.Diagnostics.EventInstance

Public Sub New (instanceId As Long, categoryId As Integer, entryType As EventLogEntryType)

Parameter

instanceId

Int64

Ein Ressourcenbezeichner, der mit einer in der Meldungsressourcendatei der Ereignisquelle definierten Zeichenfolge übereinstimmt.

categoryId

Int32

Ein Ressourcenbezeichner, der mit einer in der Kategorieressourcendatei der Ereignisquelle definierten Zeichenfolge übereinstimmt oder gleich 0 (null) ist und damit keine Kategorie für das Ereignis spezifiziert.

entryType

EventLogEntryType

Ein EventLogEntryType-Wert, der den Ereignistyp angibt.

Ausnahmen

InvalidEnumArgumentException

entryType ist kein gültiger EventLogEntryType-Wert.

ArgumentOutOfRangeException

instanceId ist ein negativer Wert oder ein Wert, der größer als UInt32.MaxValue ist.

Oder

categoryId ist ein negativer Wert oder ein Wert, der größer als UInt16.MaxValue ist.

Beispiele

Im folgenden Codebeispiel werden zwei Überwachungsereigniseinträge in das Ereignisprotokoll myNewLoggeschrieben. Im Codebeispiel werden eine neue Ereignisquelle und ein neues Ereignisprotokoll erstellt, wenn sie auf dem lokalen Computer nicht vorhanden sind. Der Ereignismeldungstext wird mithilfe eines Ressourcenbezeichners in einer Ressourcendatei angegeben.

// Create the event source if it does not exist.
String^ sourceName = "SampleApplicationSource";
if (  !EventLog::SourceExists( sourceName ) )
{
   
   // Call a local method to register the event log source
   // for the event log "myNewLog."  Use the resource file
   // EventLogMsgs.dll in the current directory for message text.
   String^ messageFile = String::Format( "{0}\\{1}", System::Environment::CurrentDirectory, "EventLogMsgs.dll" );
   CreateEventSourceSample1( messageFile );
}

// Get the event log corresponding to the existing source.
String^ myLogName = EventLog::LogNameFromSourceName( sourceName, "." );
EventLog^ myEventLog = gcnew EventLog( myLogName,".",sourceName );

// Define two audit events.
// The message identifiers correspond to the message text in the
// message resource file defined for the source.
EventInstance ^ myAuditSuccessEvent = gcnew EventInstance( AuditSuccessMsgId,0,EventLogEntryType::SuccessAudit );
EventInstance ^ myAuditFailEvent = gcnew EventInstance( AuditFailedMsgId,0,EventLogEntryType::FailureAudit );

// Insert the method name into the event log message.
array<String^>^insertStrings = {"EventLogSamples.WriteEventSample1"};

// Write the events to the event log.
myEventLog->WriteEvent( myAuditSuccessEvent, insertStrings );

// Append binary data to the audit failure event entry.
array<Byte>^binaryData = {3,4,5,6};
myEventLog->WriteEvent( myAuditFailEvent, binaryData, insertStrings );

// Create the event source if it does not exist.
string sourceName = "SampleApplicationSource";
if(!EventLog.SourceExists(sourceName))
{
    // Call a local method to register the event log source
    // for the event log "myNewLog."  Use the resource file
    // EventLogMsgs.dll in the current directory for message text.

    string messageFile =  String.Format("{0}\\{1}",
        System.Environment.CurrentDirectory,
        "EventLogMsgs.dll");

    CreateEventSourceSample1(messageFile);
}

// Get the event log corresponding to the existing source.
string myLogName = EventLog.LogNameFromSourceName(sourceName,".");

EventLog myEventLog = new EventLog(myLogName, ".", sourceName);

// Define two audit events.

// The message identifiers correspond to the message text in the
// message resource file defined for the source.
EventInstance myAuditSuccessEvent = new EventInstance(AuditSuccessMsgId, 0, EventLogEntryType.SuccessAudit);
EventInstance myAuditFailEvent = new EventInstance(AuditFailedMsgId, 0, EventLogEntryType.FailureAudit);

// Insert the method name into the event log message.
string [] insertStrings = {"EventLogSamples.WriteEventSample1"};

// Write the events to the event log.

myEventLog.WriteEvent(myAuditSuccessEvent, insertStrings);

// Append binary data to the audit failure event entry.
byte [] binaryData = { 3, 4, 5, 6 };
myEventLog.WriteEvent(myAuditFailEvent, binaryData, insertStrings);

           Dim sourceName As String = "SampleApplicationSource"

           ' Create the event source if it does not exist.
           If Not EventLog.SourceExists(sourceName)
  
               ' Call a local method to register the event log source
               ' for the event log "myNewLog."  Use the resource file
               ' EventLogMsgs.dll in the current directory for message text.

               Dim messageFile As String =  String.Format("{0}\\{1}", _
                   System.Environment.CurrentDirectory, _
                   "EventLogMsgs.dll")

               CreateEventSourceSample1(messageFile)
           End If 

           ' Get the event log corresponding to the existing source.
           Dim myLogName As String = EventLog.LogNameFromSourceName(sourceName,".")
       
           Dim myEventLog As EventLog = new EventLog(myLogName, ".", sourceName)

           ' Define two audit events.
           Dim myAuditSuccessEvent As EventInstance = new EventInstance(AuditSuccessMsgId, 0, EventLogEntryType.SuccessAudit)
           Dim myAuditFailEvent As EventInstance = new EventInstance(AuditFailedMsgId, 0, EventLogEntryType.FailureAudit)

           ' Insert the method name into the event log message.
           Dim insertStrings() As String = {"EventLogSamples.WriteEventSample1"}
           
           ' Write the events to the event log.

           myEventLog.WriteEvent(myAuditSuccessEvent, insertStrings)

           ' Append binary data to the audit failure event entry.
           Dim binaryData() As Byte = { 7, 8, 9, 10 }
           myEventLog.WriteEvent(myAuditFailEvent, binaryData, insertStrings)

Im Codebeispiel wird die folgende Meldungstextdatei verwendet, die in die Ressourcenbibliothek EventLogMsgs.dll integriert ist. Eine Nachrichtentextdatei ist die Quelle, aus der die Nachrichtenressourcendatei erstellt wird. Die Nachrichtentextdatei definiert die Ressourcenbezeichner und den Text für die Kategorie, die Ereignismeldung und die Parametereinfügungszeichenfolgen.

; // EventLogMsgs.mc  
; // ********************************************************  

; // Use the following commands to build this file:  

; //   mc -s EventLogMsgs.mc  
; //   rc EventLogMsgs.rc  
; //   link /DLL /SUBSYSTEM:WINDOWS /NOENTRY /MACHINE:x86 EventLogMsgs.Res   
; // ********************************************************  

; // - Event categories -  
; // Categories must be numbered consecutively starting at 1.  
; // ********************************************************  

MessageId=0x1  
Severity=Success  
SymbolicName=INSTALL_CATEGORY  
Language=English  
Installation  
.  

MessageId=0x2  
Severity=Success  
SymbolicName=QUERY_CATEGORY  
Language=English  
Database Query  
.  

MessageId=0x3  
Severity=Success  
SymbolicName=REFRESH_CATEGORY  
Language=English  
Data Refresh  
.  

; // - Event messages -  
; // *********************************  

MessageId = 1000  
Severity = Success  
Facility = Application  
SymbolicName = AUDIT_SUCCESS_MESSAGE_ID_1000  
Language=English  
My application message text, in English, for message id 1000, called from %1.  
.  

MessageId = 1001  
Severity = Warning  
Facility = Application  
SymbolicName = AUDIT_FAILED_MESSAGE_ID_1001  
Language=English  
My application message text, in English, for message id 1001, called from %1.  
.  

MessageId = 1002  
Severity = Success  
Facility = Application  
SymbolicName = GENERIC_INFO_MESSAGE_ID_1002  
Language=English  
My generic information message in English, for message id 1002.  
.  

MessageId = 1003  
Severity = Warning  
Facility = Application  
SymbolicName = GENERIC_WARNING_MESSAGE_ID_1003  
Language=English  
My generic warning message in English, for message id 1003, called from %1.  
.  

MessageId = 1004  
Severity = Success  
Facility = Application  
SymbolicName = UPDATE_CYCLE_COMPLETE_MESSAGE_ID_1004  
Language=English  
The update cycle is complete for %%5002.  
.  

MessageId = 1005  
Severity = Warning  
Facility = Application  
SymbolicName = SERVER_CONNECTION_DOWN_MESSAGE_ID_1005  
Language=English  
The refresh operation did not complete because the connection to server %1 could not be established.  
.  

; // - Event log display name -  
; // ********************************************************  

MessageId = 5001  
Severity = Success  
Facility = Application  
SymbolicName = EVENT_LOG_DISPLAY_NAME_MSGID  
Language=English  
Sample Event Log  
.  

; // - Event message parameters -  
; //   Language independent insertion strings  
; // ********************************************************  

MessageId = 5002  
Severity = Success  
Facility = Application  
SymbolicName = EVENT_LOG_SERVICE_NAME_MSGID  
Language=English  
SVC_UPDATE.EXE  
.  

Hinweise

Um einen Eintrag in ein Ereignisprotokoll zu schreiben, initialisieren Sie einen EventInstance , und übergeben Sie ihn an die WriteEvent -Methode. Legen Sie auf instanceId den Ressourcenbezeichner der Ereignismeldung in der entsprechenden MessageResourceFile Eigenschaft für die Quelle fest. Legen Sie den categoryId auf einen numerischen Kategoriewert oder den Ressourcenbezeichner der Ereigniskategorie in der CategoryResourceFile -Eigenschaft für die Quelle fest. Legen Sie für keine Ereigniskategorie auf categoryId Null fest.

Die Ereignisanzeige verwendet die Ressourcenbezeichner, um die entsprechenden Zeichenfolgen aus den lokalisierten Ressourcendateien für die Quelle anzuzeigen. Sie müssen die Quelle bei den entsprechenden Ressourcendateien registrieren, bevor Sie Ereignisse mithilfe von Ressourcenbezeichnern schreiben können.

Legen Sie auf entryType einen der vordefinierten Eintragstypen fest. Die Ereignisanzeige verwendet den Ereignistyp, um zu bestimmen, welches Symbol in der Listenansicht des Ereignisprotokolls angezeigt werden soll.

Weitere Informationen

• CategoryId
• InstanceId
• EventLogEntry
• WriteEvent
• EventSourceCreationData