EventInstance Konstruktory

Definice

Obor názvů:: System.Diagnostics

Sestavení:: System.Diagnostics.EventLog.dll

Sestavení:: System.dll

Balíček:: System.Diagnostics.EventLog v11.0.0-preview.2.26159.112

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Inicializuje novou instanci EventInstance třídy pomocí jazykově neutrálních informací k definování položky protokolu událostí.

Přetížení

Name	Description
EventInstance(Int64, Int32)	Inicializuje novou instanci EventInstance třídy pomocí zadaných identifikátorů prostředků pro lokalizovanou zprávu a text kategorie položky události.
EventInstance(Int64, Int32, EventLogEntryType)	Inicializuje novou instanci EventInstance třídy pomocí zadaných identifikátorů prostředků pro lokalizovanou zprávu a text kategorie položky události a zadaný typ položky protokolu událostí.

EventInstance(Int64, Int32)

Zdroj:: EventData.cs

Zdroj:: EventData.cs

Zdroj:: EventData.cs

Zdroj:: EventData.cs

Zdroj:: EventData.cs

Zdroj:: EventData.cs

Zdroj:: EventData.cs

Zdroj:: EventData.cs

Zdroj:: EventData.cs

Inicializuje novou instanci EventInstance třídy pomocí zadaných identifikátorů prostředků pro lokalizovanou zprávu a text kategorie položky události.

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)

Parametry

instanceId: Int64

Identifikátor prostředku, který odpovídá řetězci definovanému v souboru prostředků zprávy zdroje události.

categoryId: Int32

Identifikátor prostředku, který odpovídá řetězci definovanému v souboru prostředků kategorie zdroje události, nebo nula, aby se pro událost nezadála žádná kategorie.

Výjimky

ArgumentOutOfRangeException

Parametr instanceId je záporná hodnota nebo hodnota větší než UInt32.MaxValue.

nebo

Parametr categoryId je záporná hodnota nebo hodnota větší než UInt16.MaxValue.

Příklady

Následující příklad kódu zapíše položku informační události a pak znovu použije EventInstance k zápisu položky pro událost upozornění do existujícího protokolu událostí událostí. Text zprávy události se zadává pomocí identifikátoru prostředku v souboru prostředku zprávy. Příklad kódu předpokládá, že odpovídající soubor prostředků zprávy byl registrován pro zdroj.


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

Příklad kódu používá následující textový soubor zprávy, integrovaný do knihovny prostředků EventLogMsgs.dll. Textový soubor zprávy je zdrojem, ze kterého se vytvoří soubor prostředku zprávy. Textový soubor zprávy definuje identifikátory prostředků a text pro řetězce vložení kategorie, zprávy události a parametru.

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

Poznámky

Chcete-li napsat informační položku do protokolu událostí, inicializovat EventInstance a předat ji metodě WriteEvent . instanceId Nastavte identifikátor prostředku zprávy události v odpovídající MessageResourceFile vlastnosti zdroje. categoryId Nastavte hodnotu číselné kategorie nebo identifikátor prostředku kategorie události ve CategoryResourceFile vlastnosti zdroje; nastavte categoryId na nulu pro žádnou kategorii události. Vlastnost EntryType nové instance je ve výchozím nastavení nastavena Information .

Prohlížeč událostí používá identifikátory prostředků k zobrazení odpovídajících řetězců z lokalizovaných souborů prostředků pro zdroj. Před zápisem událostí pomocí identifikátorů prostředků musíte zdroj zaregistrovat s odpovídajícími soubory prostředků.

Viz také

Platí pro

EventInstance(Int64, Int32, EventLogEntryType)

Zdroj:: EventData.cs

Zdroj:: EventData.cs

Zdroj:: EventData.cs

Zdroj:: EventData.cs

Zdroj:: EventData.cs

Zdroj:: EventData.cs

Zdroj:: EventData.cs

Zdroj:: EventData.cs

Zdroj:: EventData.cs

Inicializuje novou instanci EventInstance třídy pomocí zadaných identifikátorů prostředků pro lokalizovanou zprávu a text kategorie položky události a zadaný typ položky protokolu událostí.

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)

Parametry

instanceId: Int64

Identifikátor prostředku, který odpovídá řetězci definovanému v souboru prostředků zprávy zdroje události.

categoryId: Int32

Identifikátor prostředku, který odpovídá řetězci definovanému v souboru prostředků kategorie zdroje události, nebo nula, aby se pro událost nezadála žádná kategorie.

entryType: EventLogEntryType

Hodnota EventLogEntryType , která označuje typ události.

Výjimky

InvalidEnumArgumentException

entryType není platná EventLogEntryType hodnota.

ArgumentOutOfRangeException

instanceId je záporná hodnota nebo hodnota větší než UInt32.MaxValue.

nebo

categoryId je záporná hodnota nebo hodnota větší než UInt16.MaxValue.

Příklady

Následující příklad kódu zapíše dvě položky události auditu do protokolu myNewLogudálostí . Příklad kódu vytvoří nový zdroj událostí a nový protokol událostí, pokud neexistují v místním počítači. Text zprávy události se zadává pomocí identifikátoru prostředku v souboru prostředku.


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

Poznámky

Pokud chcete zapsat položku do protokolu událostí, inicializujete EventInstance ji a předejte ji metodě WriteEvent . instanceId Nastavte identifikátor prostředku zprávy události v odpovídající MessageResourceFile vlastnosti zdroje. categoryId Nastavte hodnotu číselné kategorie nebo identifikátor prostředku kategorie události ve CategoryResourceFile vlastnosti zdroje; nastavte categoryId na nulu pro žádnou kategorii události.

entryType Nastavte na jeden z předdefinovaných typů položek. Prohlížeč událostí používá typ události k určení ikony, která se má zobrazit v zobrazení seznamu protokolu událostí.

Viz také

Platí pro

Váš názor

Byla tato stránka užitečná?

Sdílet prostřednictvím

EventInstance Konstruktory

Definice

Přetížení

EventInstance(Int64, Int32)

Parametry

Výjimky

Příklady

Poznámky

Viz také

Platí pro

EventInstance(Int64, Int32, EventLogEntryType)

Parametry

Výjimky

Příklady

Poznámky

Viz také

Platí pro

Váš názor