Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

TraceSource.TraceEvent Method (TraceEventType, Int32, String, Object[])

Writes a trace event to the trace listeners in the Listeners collection using the specified event type, event identifier, and argument array and format.

Namespace:  System.Diagnostics
Assembly:  System (in System.dll)
[<ConditionalAttribute("TRACE")>]
member TraceEvent : 
        eventType:TraceEventType * 
        id:int * 
        format:string * 
        args:Object[] -> unit 

Parameters

eventType
Type: System.Diagnostics.TraceEventType
One of the enumeration values that specifies the event type of the trace data.
id
Type: System.Int32
A numeric identifier for the event.
format
Type: System.String
A composite format string (see Remarks) that contains text intermixed with zero or more format items, which correspond to objects in the args array.
args
Type: System.Object[]
An object array containing zero or more objects to format.
ExceptionCondition
ArgumentNullException

format is a null reference (Nothing in Visual Basic).

FormatException

format is invalid.

-or-

The number that indicates an argument to format is less than zero, or greater than or equal to the number of specified objects to format.

ObjectDisposedException

An attempt was made to trace an event during finalization.

For more information about the format parameter, see Composite Formatting.

The TraceEvent method is intended to trace events that can be processed automatically by tools. For example, a monitoring tool can notify an administrator if a specific event is traced by a specific source.

The TraceEvent method calls the ShouldTrace method of the SourceSwitch object returned by the Switch property. If ShouldTrace returns true, TraceEvent calls the corresponding TraceEvent method of each listener. Otherwise, TraceEvent returns without calling the listeners' methods.

The trace content is listener specific. The default TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) method writes the source name, event type, and numeric identity in the trace header, then calls the String.Format(IFormatProvider, String, Object[]) method, passing the format string and args array and using the CultureInfo.InvariantCulture property to format the string as the message output.

NoteNote

The EventLogTraceListener object is limited to a maximum id value of 65,535. If the id value specified is greater than 65,535, the EventLogTraceListener object uses 65,535.

The following code example shows the use of the TraceEvent(TraceEventType, Int32) method to pass a trace event to the listeners. This code example is part of a larger example provided for the TraceSource class.

No code example is currently available or this language may not be supported.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.