EventInstance Konstruktorok

Definíció

Névtér:: System.Diagnostics

Szerelvény:: System.Diagnostics.EventLog.dll

Szerelvény:: System.dll

Csomag:: System.Diagnostics.EventLog v11.0.0-preview.7.26381.103

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Inicializálja az osztály új példányát nyelvsemleges EventInstance adatok használatával egy eseménynapló-bejegyzés definiálásához.

Túlterhelések

Name	Description
EventInstance(Int64, Int32)	Inicializálja az osztály új példányát az EventInstance eseménybejegyzés honosított üzenetéhez és kategóriaszövegéhez megadott erőforrás-azonosítók használatával.
EventInstance(Int64, Int32, EventLogEntryType)	Inicializálja az osztály új példányát az EventInstance eseménybejegyzés honosított üzenetéhez és kategóriaszövegéhez és a megadott eseménynapló-bejegyzéstípushoz megadott erőforrás-azonosítók használatával.

EventInstance(Int64, Int32)

Forrás:: EventData.cs

Forrás:: EventData.cs

Forrás:: EventData.cs

Forrás:: EventData.cs

Forrás:: EventData.cs

Forrás:: EventData.cs

Forrás:: EventData.cs

Forrás:: EventData.cs

Inicializálja az osztály új példányát az EventInstance eseménybejegyzés honosított üzenetéhez és kategóriaszövegéhez megadott erőforrás-azonosítók használatával.

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)

Paraméterek

instanceId: Int64

Az eseményforrás üzeneterőforrás-fájljában definiált sztringnek megfelelő erőforrás-azonosító.

categoryId: Int32

Az eseményforrás kategória-erőforrásfájljában definiált sztringnek megfelelő erőforrás-azonosító, vagy nulla, amely nem ad meg kategóriát az eseményhez.

Kivételek

ArgumentOutOfRangeException

A instanceId paraméter negatív érték vagy nagyobb, mint az UInt32.MaxValue.

-vagy-

A categoryId paraméter negatív érték vagy nagyobb, mint az UInt16.MaxValue.

Példák

Az alábbi példakód egy tájékoztató eseménybejegyzést ír, majd újra felhasználja a EventInstance figyelmeztető esemény bejegyzésének megírásához egy meglévő eseménynaplóba. Az eseményüzenet szövege egy üzenet-erőforrásfájl erőforrás-azonosítójának használatával van megadva. A példakód feltételezi, hogy a megfelelő üzenet erőforrásfájlja regisztrálva van a forráshoz.


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

A példakód az erőforrástárba EventLogMsgs.dllbeépített alábbi üzenetszövegfájlt használja. Az üzenetszövegfájl az a forrás, amelyből az üzenet erőforrásfájlja létrejön. Az üzenet szövegfájlja határozza meg a kategória, eseményüzenet és paraméterszúró sztringek erőforrás-azonosítóit és szövegét.

; // 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
.

Megjegyzések

Ha információs bejegyzést szeretne írni egy eseménynaplóba, inicializáljon egy bejegyzést EventInstance , és adja át a WriteEvent metódusnak. Állítsa az instanceId eseményüzenet erőforrás-azonosítójára a forrás megfelelő MessageResourceFile tulajdonságában. Állítsa be a categoryId számkategória értékét vagy az eseménykategória erőforrás-azonosítóját a CategoryResourceFile forrás tulajdonságában; állítsa a categoryId nullát eseménykategória nélkül. Az EntryType új példány tulajdonsága alapértelmezés szerint be van állítva Information .

A eseménymegtekintő az erőforrás-azonosítókkal jeleníti meg a forrás honosított erőforrásfájljainak megfelelő sztringeket. Mielőtt eseményeket írhat az erőforrás-azonosítók használatával, regisztrálnia kell a forrást a megfelelő erőforrásfájlokban.

Lásd még

A következőre érvényes:

EventInstance(Int64, Int32, EventLogEntryType)

Forrás:: EventData.cs

Forrás:: EventData.cs

Forrás:: EventData.cs

Forrás:: EventData.cs

Forrás:: EventData.cs

Forrás:: EventData.cs

Forrás:: EventData.cs

Forrás:: EventData.cs

Inicializálja az osztály új példányát az EventInstance eseménybejegyzés honosított üzenetéhez és kategóriaszövegéhez és a megadott eseménynapló-bejegyzéstípushoz megadott erőforrás-azonosítók használatával.

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)

Paraméterek

instanceId: Int64

Az eseményforrás üzeneterőforrás-fájljában definiált sztringnek megfelelő erőforrás-azonosító.

categoryId: Int32

Az eseményforrás kategória-erőforrásfájljában definiált sztringnek megfelelő erőforrás-azonosító, vagy nulla, amely nem ad meg kategóriát az eseményhez.

entryType: EventLogEntryType

Az EventLogEntryType esemény típusát jelző érték.

Kivételek

InvalidEnumArgumentException

entryType érvénytelen EventLogEntryType érték.

ArgumentOutOfRangeException

instanceId negatív érték vagy az UInt32.MaxValue értéknél nagyobb érték.

-vagy-

categoryId negatív érték vagy az UInt16.MaxValue értéknél nagyobb érték.

Példák

Az alábbi példakód két naplózási eseménybejegyzést ír az eseménynaplóba myNewLog. A példakód létrehoz egy új eseményforrást és egy új eseménynaplót, ha azok nem léteznek a helyi számítógépen. Az eseményüzenet szövege erőforrás-azonosítóval van megadva egy erőforrásfájlban.


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

; // 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
.

Megjegyzések

Ha bejegyzést szeretne írni egy eseménynaplóba, inicializáljon egy bejegyzést EventInstance , és adja át a WriteEvent metódusnak. Állítsa az instanceId eseményüzenet erőforrás-azonosítójára a forrás megfelelő MessageResourceFile tulajdonságában. Állítsa be a categoryId számkategória értékét vagy az eseménykategória erőforrás-azonosítóját a CategoryResourceFile forrás tulajdonságában; állítsa a categoryId nullát eseménykategória nélkül.

Állítsa be az entryType egyik előre definiált bejegyzéstípust. A eseménymegtekintő az eseménytípus használatával határozza meg, hogy melyik ikon jelenjen meg az eseménynapló listanézetében.

Lásd még

A következőre érvényes:

Visszajelzés

Hasznosnak találta ezt az oldalt?