StackTrace Constructor (Boolean)

.NET Framework (current version)

Initializes a new instance of the StackTrace class from the caller's frame, optionally capturing source information.

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

Syntax

public:
StackTrace(
	bool fNeedFileInfo
)

Parameters

fNeedFileInfo: Type: System::Boolean
true to capture the file name, line number, and column number; otherwise, false.

Remarks

The StackTrace is created with the caller's current thread.

Examples

The following code example demonstrates various StackTrace constructor methods.

C++

void Level2Method()
{
   try
   {
      ClassLevel3^ nestedClass = gcnew ClassLevel3;
      nestedClass->Level3Method();
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( " Level2Method exception handler" );

      // Display the full call stack at this level.
      StackTrace^ st1 = gcnew StackTrace( true );
      Console::WriteLine( " Stack trace for this level: {0}", st1->ToString() );

      // Build a stack trace from one frame, skipping the
      // current frame and using the next frame.
      StackTrace^ st2 = gcnew StackTrace( gcnew StackFrame( 1,true ) );
      Console::WriteLine( " Stack trace built with next level frame: {0}", st2->ToString() );

      // Build a stack trace skipping the current frame, and
      // including all the other frames.
      StackTrace^ st3 = gcnew StackTrace( 1,true );
      Console::WriteLine( " Stack trace built from the next level up: {0}", st3->ToString() );
      Console::WriteLine();
      Console::WriteLine( "   ... throwing exception to next level ..." );
      Console::WriteLine( "-------------------------------------------------\n" );
      throw e;
   }

}

Version Information

.NET Framework
Available since 1.1
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0