TraceSource.TraceInformation Method (String, Object[]) (System.Diagnostics)

Switch View :
ScriptFree
.NET Framework Class Library
TraceSource.TraceInformation Method (String, Object[])

Writes an informational message to the trace listeners in the Listeners collection using the specified object array and formatting information.

Namespace:  System.Diagnostics
Assembly:  System (in System.dll)
Syntax

Visual Basic
<ConditionalAttribute("TRACE")> _
Public Sub TraceInformation ( _
	format As String, _
	ParamArray args As Object() _
)
C#
[ConditionalAttribute("TRACE")]
public void TraceInformation(
	string format,
	params Object[] args
)
Visual C++
[ConditionalAttribute(L"TRACE")]
public:
void TraceInformation(
	String^ format, 
	... array<Object^>^ args
)
F#
[<ConditionalAttribute("TRACE")>]
member TraceInformation : 
        format:string * 
        args:Object[] -> unit 

Parameters

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 array containing zero or more objects to format.
Exceptions

Exception Condition
ArgumentNullException

format is null.

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.

Remarks

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

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

TraceInformation(String, Object[]) calls the TraceEvent(TraceEventType, Int32, String, Object[]) method, setting eventType to TraceEventType.Information and passing the message content as an object array with formatting information. The TraceEvent(TraceEventType, Int32, String, Object[]) method in turn calls the TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) method of each trace listener.

Version Information

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Platforms

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.
See Also

Reference

Other Resources

Community Content

ray247
Is it a typo on the 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.