Home Library Learn Downloads Support Community
Sign in | United States - English | |
This topic has not yet been rated - Rate this topic

TraceSource.TraceInformation Method (String)

.NET Framework 4

Writes an informational message to the trace listeners in the Listeners collection using the specified message.

Namespace:  System.Diagnostics
Assembly:  System (in System.dll)
C#
C++
F#
VB
Copy 
[ConditionalAttribute("TRACE")]
public void TraceInformation(
	string message
)

Parameters

message
Type: System.String
The informative message to write.
Exception Condition
ObjectDisposedException

An attempt was made to trace an event during finalization.

The TraceInformation method provides an informational message intended to be read by users and not by tools.

TraceInformation(String) calls the TraceEvent(TraceEventType, Int32, String) method, setting eventType to TraceEventType.Information and passing the informative message as the message string. The TraceEvent(TraceEventType, Int32, String) method in turn calls the TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) method of each trace listener.

.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.
Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ
Misinformation in remarks
It appears that the TraceInformation method of the TraceSource class does not call into the TraceEvent(TraceEventCache, string, TraceEventType, int, string) method of derived listeners as is stated in the Remarks above.

If you create a custom trace listener and override the three TraceEvent signatures of the TraceListener base class and then call the TraceInformation method of a TraceSource you'll see upon debugging that the execution actually jumps into the signature with the params object[] array. TraceEvent(TraceEventCache, string, TraceEventType, int, string, params object[])

History