Writes an entry of the specified EventLogEntryType to the event log. Valid types are Error, Warning, Information, Success Audit, and Failure Audit.
[Visual Basic] Overloads Public Sub WriteEntry( _ ByVal message As String, _ ByVal type As EventLogEntryType _ ) [C#] public void WriteEntry( string message, EventLogEntryType type ); [C++] public: void WriteEntry( String* message, EventLogEntryType type ); [JScript] public function WriteEntry( message : String, type : EventLogEntryType );
Exception Type | Condition |
---|---|
ArgumentException | The Source property of the EventLog has not been set.
-or- The method has attempted to create a new event Source, but the computer name is not valid. -or- The method has attempted to create a new event Source, but the source name was not specified. -or- The method has attempted to create a new event Source, but the source already exists on the computer. -or- The method has attempted to create a new Log, but the first eight characters of the log name are not unique on the computer. -or- The method has attempted to open the event log with read access, but the Log property was not specified. -or- The method has attempted to open the event log with write access, but the Source property was not specified. -or- The message string is too long. The size must be less than 16384 bytes. -or- The source is not registered to the given log. |
Exception | The registry entry for the Log could not be opened on a remote computer. |
InvalidOperationException | The method has attempted to open the event log with write access, but you do not have write access to the log. |
Win32Exception | The method attempted to release the event log's read or write handle but did not do so successfully.
-or- The method attempted to open the event log with read access but was unable to do so. -or- The event could not be reported to the log. |
SystemException | The event log could not be notified to start listenting for events. |
WriteEntry lets you specify a string message to write to the log. This method writes the given string directly to the log; it does not use a localizable message file.
Use this overload if you want to write an entry of a specified EventLogEntryType to the event log. The type is indicated in the Event Viewer for a log by an icon and text in the Type column.
You must set the Source property on your EventLog component before you can write entries to the log. You can call CreateEventSource on a new Source to register it before writing to the event log, but this is not necessary. If a new Source has not been registered on the computer to which your component is writing, WriteEntry calls CreateEventSource automatically and registers the Source for you.
If you have not specified a MachineName for your EventLog instance before calling CreateEventSource or WriteEntry, the local computer (".") is assumed.
If the system needs to register the Source through a call to WriteEntry and the Log property has not been set on your EventLog instance, it defaults to the Application log.
Note Many of the exceptions listed above are generated by errors raised during the process of registering the Source.
The following example connects to a log with the source "myNewSource". It then writes a warning type entry to the log. This example assumes there is an existing source named "myNewSource" on the local computer.
Import the System.Diagnostics namespace for this example.
[Visual Basic]
Private Sub WriteWarningToEventLog() 'Declare a new event log and event log entry. Dim evtLog As EventLog 'Instantiate a new event log. evtLog = New EventLog 'Connect the source to the event instance. evtLog.Source = "myNewSource" 'Write an entry to the event log. evtLog.WriteEntry("Event log warning.", EventLogEntryType.Warning) End Sub
EventLog Class | EventLog Members | System.Diagnostics Namespace | EventLog.WriteEntry Overload List | EventLogEntryType | Source | CreateEventSource | DeleteEventSource | SourceExists