StackTrace Konstruktoren

Definition

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.StackTrace.dll

Initialisiert eine neue Instanz der StackTrace-Klasse.

Überlädt

StackTrace()	Initialisiert eine neue Instanz der StackTrace-Klasse aus dem Rahmen des Aufrufers.
StackTrace(Boolean)	Initialisiert eine neue Instanz der StackTrace-Klasse aus dem Rahmen des Aufrufers und zeichnet bei Bedarf Quellinformationen auf.
StackTrace(IEnumerable<StackFrame>)	Erstellt eine Stapelablaufverfolgung aus einer Gruppe von StackFrame Objekten.
StackTrace(StackFrame)	Initialisiert eine neue Instanz der StackTrace-Klasse, die einen einzelnen Rahmen enthält.
StackTrace(Exception)	Initialisiert eine neue Instanz der StackTrace-Klasse unter Verwendung des bereitgestellten Ausnahmeobjekts.
StackTrace(Int32)	Initialisiert eine neue Instanz der StackTrace-Klasse aus dem Rahmen des Aufrufers, wobei die angegebene Anzahl von Rahmen übersprungen wird.
StackTrace(Exception, Int32)	Initialisiert eine neue Instanz der StackTrace-Klasse unter Verwendung des bereitgestellten Ausnahmeobjekts, wobei die angegebene Anzahl von Rahmen übersprungen wird.
StackTrace(Int32, Boolean)	Initialisiert eine neue Instanz der StackTrace-Klasse aus dem Rahmen des Aufrufers. Dabei wird die angegebene Anzahl von Rahmen übersprungen, und Quellinformationen können wahlweise aufgezeichnet werden.
StackTrace(Exception, Int32, Boolean)	Initialisiert eine neue Instanz der StackTrace-Klasse unter Verwendung des bereitgestellten Ausnahmeobjekts. Dabei wird die angegebene Anzahl von Rahmen übersprungen, und Quellinformationen können wahlweise aufgezeichnet werden.
StackTrace(Exception, Boolean)	Initialisiert eine neue Instanz der StackTrace-Klasse unter Verwendung des bereitgestellten Ausnahmeobjekts und zeichnet optional Quellinformationen auf.

StackTrace()

Quelle:

StackTrace.cs

Initialisiert eine neue Instanz der StackTrace-Klasse aus dem Rahmen des Aufrufers.

public:
 StackTrace();

public StackTrace ();

Public Sub New ()

Beispiele

Im folgenden Codebeispiel werden die ersten und letzten Funktionsaufrufe in einer Stapelablaufverfolgung angezeigt.

void Level5Method()
{
   try
   {
      ClassLevel6^ nestedClass = gcnew ClassLevel6;
      nestedClass->Level6Method();
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( " Level5Method exception handler" );
      StackTrace^ st = gcnew StackTrace;
      
      // Display the most recent function call.
      StackFrame^ sf = st->GetFrame( 0 );
      Console::WriteLine();
      Console::WriteLine( "  Exception in method: " );
      Console::WriteLine( "      {0}", sf->GetMethod() );
      if ( st->FrameCount > 1 )
      {
         
         // Display the highest-level function call
         // in the trace.
         sf = st->GetFrame( st->FrameCount - 1 );
         Console::WriteLine( "  Original function call at top of call stack):" );
         Console::WriteLine( "      {0}", sf->GetMethod() );
      }
      Console::WriteLine();
      Console::WriteLine( "   ... throwing exception to next level ..." );
      Console::WriteLine( "-------------------------------------------------\n" );
      throw e;
   }

}

public void Level5Method()
{
   try
   {
      ClassLevel6 nestedClass = new ClassLevel6();
      nestedClass.Level6Method();
   }
   catch (Exception e)
   {
      Console.WriteLine(" Level5Method exception handler");

      StackTrace st = new StackTrace();

      // Display the most recent function call.
      StackFrame sf = st.GetFrame(0);
      Console.WriteLine();
      Console.WriteLine("  Exception in method: ");
      Console.WriteLine("      {0}", sf.GetMethod());

      if (st.FrameCount >1)
      {
         // Display the highest-level function call
         // in the trace.
         sf = st.GetFrame(st.FrameCount-1);
         Console.WriteLine("  Original function call at top of call stack):");
         Console.WriteLine("      {0}", sf.GetMethod());
      }

      Console.WriteLine();
      Console.WriteLine("   ... throwing exception to next level ...");
      Console.WriteLine("-------------------------------------------------\n");
      throw e;
   }
}

Public Sub Level5Method()
   Try
      Dim nestedClass As New ClassLevel6()
      nestedClass.Level6Method()
   Catch e As Exception
      Console.WriteLine(" Level5Method exception handler")
      
      Dim st As New StackTrace()
      
      ' Display the most recent function call.
      Dim sf As StackFrame = st.GetFrame(0)
      Console.WriteLine()
      Console.WriteLine("  Exception in method: ")
      Console.WriteLine("      {0}", sf.GetMethod())
      
      If st.FrameCount > 1 Then
         ' Display the highest-level function call in the trace.
         sf = st.GetFrame((st.FrameCount - 1))
         Console.WriteLine("  Original function call at top of call stack):")
         Console.WriteLine("      {0}", sf.GetMethod())
      End If
      
      Console.WriteLine()
      Console.WriteLine("   ... throwing exception to next level ...")
      Console.WriteLine("-------------------------------------------------")
      Console.WriteLine()
      Throw e
   End Try
End Sub

Hinweise

Der StackTrace wird mit dem aktuellen Thread des Aufrufers erstellt und enthält keinen Dateinamen, keine Zeilennummer oder Spalteninformationen.

Verwenden Sie diesen parameterlosen Konstruktor, wenn Sie eine vollständige Ablaufverfolgung mit nur Zusammenfassungsmethodeninformationen über den Aufrufstapel benötigen.

StackTrace(Boolean)

Quelle:

StackTrace.cs

Initialisiert eine neue Instanz der StackTrace-Klasse aus dem Rahmen des Aufrufers und zeichnet bei Bedarf Quellinformationen auf.

public:
 StackTrace(bool fNeedFileInfo);

public StackTrace (bool fNeedFileInfo);

new System.Diagnostics.StackTrace : bool -> System.Diagnostics.StackTrace

Public Sub New (fNeedFileInfo As Boolean)

Parameter

fNeedFileInfo

Boolean

true, wenn Dateiname, Zeilennummer und Spaltennummer aufgezeichnet werden sollen, andernfalls false.

Beispiele

Im folgenden Codebeispiel werden verschiedene StackTrace Konstruktormethoden veranschaulicht.

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;
   }

}

public void Level2Method()
{
   try
   {
      ClassLevel3 nestedClass = new ClassLevel3();
      nestedClass.Level3Method();
   }
   catch (Exception e)
   {
      Console.WriteLine(" Level2Method exception handler");

      // Display the full call stack at this level.
      StackTrace st1 = new 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 = new StackTrace(new 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 = new 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;
   }
}

Public Sub Level2Method()
   Try
      Dim nestedClass As New ClassLevel3
      nestedClass.Level3Method()
   
   Catch e As Exception
      Console.WriteLine(" Level2Method exception handler")
      
      ' Display the full call stack at this level.
      Dim st1 As New 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.
      Dim st2 As New StackTrace(New 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.
      Dim st3 As New 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("-------------------------------------------------")
      Console.WriteLine()
      Throw e
   End Try
End Sub

Hinweise

Der StackTrace wird mit dem aktuellen Thread des Aufrufers erstellt.

StackTrace(IEnumerable<StackFrame>)

Quelle:

StackTrace.cs

Erstellt eine Stapelablaufverfolgung aus einer Gruppe von StackFrame Objekten.

public:
 StackTrace(System::Collections::Generic::IEnumerable<System::Diagnostics::StackFrame ^> ^ frames);

public StackTrace (System.Collections.Generic.IEnumerable<System.Diagnostics.StackFrame> frames);

new System.Diagnostics.StackTrace : seq<System.Diagnostics.StackFrame> -> System.Diagnostics.StackTrace

Public Sub New (frames As IEnumerable(Of StackFrame))

Parameter

frames

IEnumerable<StackFrame>

Der Satz von Stapelrahmen, die in der Stapelablaufverfolgung vorhanden sein sollen.

StackTrace(StackFrame)

Quelle:

StackTrace.cs

Initialisiert eine neue Instanz der StackTrace-Klasse, die einen einzelnen Rahmen enthält.

public:
 StackTrace(System::Diagnostics::StackFrame ^ frame);

public StackTrace (System.Diagnostics.StackFrame frame);

new System.Diagnostics.StackTrace : System.Diagnostics.StackFrame -> System.Diagnostics.StackTrace

Public Sub New (frame As StackFrame)

Parameter

frame

StackFrame

Der Rahmen, den das StackTrace-Objekt enthalten soll.

Beispiele

Im folgenden Codebeispiel werden Stapelablaufverfolgungsinformationen in einen Ereignisprotokolleintrag geschrieben.

StackFrame^ fr = gcnew StackFrame( 1,true );
StackTrace^ st = gcnew StackTrace( fr );
EventLog::WriteEntry( fr->GetMethod()->Name, st->ToString(), EventLogEntryType::Warning );

StackFrame fr = new StackFrame(1,true);
StackTrace st = new StackTrace(fr);
EventLog.WriteEntry(fr.GetMethod().Name,
                    st.ToString(),
                    EventLogEntryType.Warning);

Dim frame As New StackFrame(1, True)
Dim strace As New StackTrace(frame)            

EventLog.WriteEntry(frame.GetMethod().Name, _
                    strace.ToString(), _
                    EventLogEntryType.Warning)

Hinweise

Verwenden Sie diesen Konstruktor, wenn Sie den Mehraufwand einer vollständigen Stapelablaufverfolgung nicht möchten.

Weitere Informationen

• StackFrame

StackTrace(Exception)

Quelle:

StackTrace.cs

Initialisiert eine neue Instanz der StackTrace-Klasse unter Verwendung des bereitgestellten Ausnahmeobjekts.

public:
 StackTrace(Exception ^ e);

public StackTrace (Exception e);

new System.Diagnostics.StackTrace : Exception -> System.Diagnostics.StackTrace

Public Sub New (e As Exception)

Parameter

e

Exception

Das Ausnahmeobjekt, von dem aus die Stapelüberwachung erstellt werden soll.

Ausnahmen

ArgumentNullException

Der Parameter e ist null.

Hinweise

Der StackTrace wird mit dem aktuellen Thread des Aufrufers erstellt und enthält keinen Dateinamen, keine Zeilennummer oder Spalteninformationen.

Die resultierende Stapelablaufverfolgung beschreibt den Stapel zum Zeitpunkt der Ausnahme.

Weitere Informationen

• Exception

StackTrace(Int32)

Quelle:

StackTrace.cs

Initialisiert eine neue Instanz der StackTrace-Klasse aus dem Rahmen des Aufrufers, wobei die angegebene Anzahl von Rahmen übersprungen wird.

public:
 StackTrace(int skipFrames);

public StackTrace (int skipFrames);

new System.Diagnostics.StackTrace : int -> System.Diagnostics.StackTrace

Public Sub New (skipFrames As Integer)

Parameter

skipFrames

Int32

Die Anzahl der Stapelrahmen, ab der die Überwachung begonnen werden soll.

Ausnahmen

ArgumentOutOfRangeException

Der skipFrames-Parameter ist negativ.

Hinweise

Der StackTrace wird mit dem aktuellen Thread des Aufrufers erstellt und enthält keinen Dateinamen, keine Zeilennummer oder Spalteninformationen.

Wenn die Anzahl der zu überspringenden Frames größer oder gleich der Gesamtzahl der Frames auf dem Aufrufstapel zum Zeitpunkt der Erstellung des instance ist, enthält die StackTrace keine Frames.

StackTrace(Exception, Int32)

Quelle:

StackTrace.cs

Initialisiert eine neue Instanz der StackTrace-Klasse unter Verwendung des bereitgestellten Ausnahmeobjekts, wobei die angegebene Anzahl von Rahmen übersprungen wird.

public:
 StackTrace(Exception ^ e, int skipFrames);

public StackTrace (Exception e, int skipFrames);

new System.Diagnostics.StackTrace : Exception * int -> System.Diagnostics.StackTrace

Public Sub New (e As Exception, skipFrames As Integer)

Parameter

e

Exception

Das Ausnahmeobjekt, von dem aus die Stapelüberwachung erstellt werden soll.

skipFrames

Int32

Die Anzahl der Stapelrahmen, ab der die Überwachung begonnen werden soll.

Ausnahmen

ArgumentNullException

Der Parameter e ist null.

ArgumentOutOfRangeException

Der skipFrames-Parameter ist negativ.

Hinweise

Der StackTrace enthält keinen Dateinamen, keine Zeilennummer oder Spalteninformationen.

Die resultierende Stapelablaufverfolgung beschreibt den Stapel zum Zeitpunkt der Ausnahme.

Wenn die Anzahl der zu überspringenden Frames größer oder gleich der Gesamtzahl der Frames auf dem Aufrufstapel zum Zeitpunkt der Erstellung des instance ist, enthält die StackTrace keine Frames.

Weitere Informationen

• Exception

StackTrace(Int32, Boolean)

Quelle:

StackTrace.cs

Initialisiert eine neue Instanz der StackTrace-Klasse aus dem Rahmen des Aufrufers. Dabei wird die angegebene Anzahl von Rahmen übersprungen, und Quellinformationen können wahlweise aufgezeichnet werden.

public:
 StackTrace(int skipFrames, bool fNeedFileInfo);

public StackTrace (int skipFrames, bool fNeedFileInfo);

new System.Diagnostics.StackTrace : int * bool -> System.Diagnostics.StackTrace

Public Sub New (skipFrames As Integer, fNeedFileInfo As Boolean)

Parameter

skipFrames

Int32

Die Anzahl der Stapelrahmen, ab der die Überwachung begonnen werden soll.

fNeedFileInfo

Boolean

true, wenn Dateiname, Zeilennummer und Spaltennummer aufgezeichnet werden sollen, andernfalls false.

Ausnahmen

ArgumentOutOfRangeException

Der skipFrames-Parameter ist negativ.

Beispiele

Im folgenden Codebeispiel werden verschiedene StackTrace Konstruktormethoden veranschaulicht.

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;
   }

}

public void Level2Method()
{
   try
   {
      ClassLevel3 nestedClass = new ClassLevel3();
      nestedClass.Level3Method();
   }
   catch (Exception e)
   {
      Console.WriteLine(" Level2Method exception handler");

      // Display the full call stack at this level.
      StackTrace st1 = new 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 = new StackTrace(new 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 = new 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;
   }
}

Public Sub Level2Method()
   Try
      Dim nestedClass As New ClassLevel3
      nestedClass.Level3Method()
   
   Catch e As Exception
      Console.WriteLine(" Level2Method exception handler")
      
      ' Display the full call stack at this level.
      Dim st1 As New 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.
      Dim st2 As New StackTrace(New 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.
      Dim st3 As New 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("-------------------------------------------------")
      Console.WriteLine()
      Throw e
   End Try
End Sub

Hinweise

Wenn die Anzahl der zu überspringenden Frames größer oder gleich der Gesamtzahl der Frames auf dem Aufrufstapel zum Zeitpunkt der Erstellung des instance ist, enthält die StackTrace keine Frames.

StackTrace(Exception, Int32, Boolean)

Quelle:

StackTrace.cs

Initialisiert eine neue Instanz der StackTrace-Klasse unter Verwendung des bereitgestellten Ausnahmeobjekts. Dabei wird die angegebene Anzahl von Rahmen übersprungen, und Quellinformationen können wahlweise aufgezeichnet werden.

public:
 StackTrace(Exception ^ e, int skipFrames, bool fNeedFileInfo);

public StackTrace (Exception e, int skipFrames, bool fNeedFileInfo);

new System.Diagnostics.StackTrace : Exception * int * bool -> System.Diagnostics.StackTrace

Public Sub New (e As Exception, skipFrames As Integer, fNeedFileInfo As Boolean)

Parameter

e

Exception

Das Ausnahmeobjekt, von dem aus die Stapelüberwachung erstellt werden soll.

skipFrames

Int32

Die Anzahl der Stapelrahmen, ab der die Überwachung begonnen werden soll.

fNeedFileInfo

Boolean

true, wenn Dateiname, Zeilennummer und Spaltennummer aufgezeichnet werden sollen, andernfalls false.

Ausnahmen

ArgumentNullException

Der Parameter e ist null.

ArgumentOutOfRangeException

Der skipFrames-Parameter ist negativ.

Hinweise

Die resultierende Stapelablaufverfolgung beschreibt den Stapel zum Zeitpunkt der Ausnahme.

Wenn die Anzahl der zu überspringenden Frames größer oder gleich der Gesamtzahl der Frames auf dem Aufrufstapel zum Zeitpunkt der Erstellung des instance ist, enthält die StackTrace keine Frames.

Weitere Informationen

• Exception

StackTrace(Exception, Boolean)

Quelle:

StackTrace.cs

Initialisiert eine neue Instanz der StackTrace-Klasse unter Verwendung des bereitgestellten Ausnahmeobjekts und zeichnet optional Quellinformationen auf.

public:
 StackTrace(Exception ^ e, bool fNeedFileInfo);

public StackTrace (Exception e, bool fNeedFileInfo);

new System.Diagnostics.StackTrace : Exception * bool -> System.Diagnostics.StackTrace

Public Sub New (e As Exception, fNeedFileInfo As Boolean)

Parameter

e

Exception

Das Ausnahmeobjekt, von dem aus die Stapelüberwachung erstellt werden soll.

fNeedFileInfo

Boolean

true, wenn Dateiname, Zeilennummer und Spaltennummer aufgezeichnet werden sollen, andernfalls false.

Ausnahmen

ArgumentNullException

Der Parameter e ist null.

Hinweise

Die resultierende Stapelablaufverfolgung beschreibt den Stapel zum Zeitpunkt der Ausnahme.

Weitere Informationen

• Exception