StackFrame 생성자

정의

네임스페이스:

System.Diagnostics

어셈블리:

System.Diagnostics.StackTrace.dll

StackFrame 클래스의 새 인스턴스를 초기화합니다.

오버로드

StackFrame()	StackFrame 클래스의 새 인스턴스를 초기화합니다.
StackFrame(Int32)	현재 스택 프레임 위의 프레임에 해당하는 StackFrame 클래스의 새 인스턴스를 초기화합니다.
StackFrame(Boolean)	필요에 따라 소스 정보를 캡처하고 StackFrame 클래스의 새 인스턴스를 초기화합니다.
StackFrame(String, Int32)	지정된 파일 이름과 줄 번호만 포함하는 StackFrame 클래스의 새 인스턴스를 초기화합니다.
StackFrame(Int32, Boolean)	필요에 따라 소스 정보를 캡처하고 현재 스택 프레임 위의 프레임에 해당하는 StackFrame 클래스의 새 인스턴스를 초기화합니다.
StackFrame(String, Int32, Int32)	지정된 파일 이름, 줄 번호 및 열 번호만 포함하는 StackFrame 클래스의 새 인스턴스를 초기화합니다.

StackFrame()

Source:

StackFrame.cs

StackFrame 클래스의 새 인스턴스를 초기화합니다.

public:
 StackFrame();

public StackFrame ();

Public Sub New ()

StackFrame(Int32)

Source:

StackFrame.cs

현재 스택 프레임 위의 프레임에 해당하는 StackFrame 클래스의 새 인스턴스를 초기화합니다.

public:
 StackFrame(int skipFrames);

public StackFrame (int skipFrames);

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

Public Sub New (skipFrames As Integer)

매개 변수

skipFrames

Int32

건너뛸 스택 프레임의 개수입니다.

예제

다음 예제에서는 사용 된 StackFrame(Int32) 생성자입니다. 이 코드 예제는에 대해 제공 된 큰 예제의 일부는 StackFrame 클래스입니다.

void InternalMethod()
{
   try
   {
      ClassLevel2^ nestedClass = gcnew ClassLevel2;
      nestedClass->Level2Method();
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( " InternalMethod exception handler" );
      
      // Build a stack trace from one frame, skipping the
      // current frame and using the next frame.  By
      // default, file and line information are not displayed.
      StackTrace^ st = gcnew StackTrace( gcnew StackFrame( 1 ) );
      Console::WriteLine( " Stack trace for next level frame: {0}", st->ToString() );
      Console::WriteLine( " Stack frame for next level: " );
      Console::WriteLine( "   {0}", st->GetFrame( 0 )->ToString() );
      Console::WriteLine( " Line Number: {0}", st->GetFrame( 0 )->GetFileLineNumber().ToString() );
      Console::WriteLine();
      Console::WriteLine( "   ... throwing exception to next level ..." );
      Console::WriteLine( "-------------------------------------------------\n" );
      throw e;
   }

}

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

      // Build a stack trace from one frame, skipping the
      // current frame and using the next frame.  By
      // default, file and line information are not displayed.
      StackTrace st = new StackTrace(new StackFrame(1));
      Console.WriteLine(" Stack trace for next level frame: {0}",
         st.ToString());
      Console.WriteLine(" Stack frame for next level: ");
      Console.WriteLine("   {0}", st.GetFrame(0).ToString());

      Console.WriteLine(" Line Number: {0}",
         st.GetFrame(0).GetFileLineNumber().ToString());

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

Public Sub InternalMethod()
   Try
      Dim nestedClass As New ClassLevel2
      nestedClass.Level2Method()
   Catch e As Exception
      Console.WriteLine(" InternalMethod exception handler")
      
      ' Build a stack trace from one frame, skipping the 
      ' current frame and using the next frame.  By default,
      ' file and line information are not displayed.
      Dim st As New StackTrace(New StackFrame(1))
      Console.WriteLine(" Stack trace for next level frame: {0}", _
         st.ToString())
      Console.WriteLine(" Stack frame for next level: ")
      Console.WriteLine("   {0}", st.GetFrame(0).ToString())
      
      Console.WriteLine(" Line Number: {0}", _
         st.GetFrame(0).GetFileLineNumber().ToString())
      
      Console.WriteLine()
      Console.WriteLine("   ... throwing exception to next level ...")
      Console.WriteLine("-------------------------------------------------")
      Console.WriteLine()
      Throw e
   End Try
End Sub

StackFrame(Boolean)

Source:

StackFrame.cs

필요에 따라 소스 정보를 캡처하고 StackFrame 클래스의 새 인스턴스를 초기화합니다.

public:
 StackFrame(bool needFileInfo);

public StackFrame (bool needFileInfo);

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

Public Sub New (needFileInfo As Boolean)

매개 변수

needFileInfo

Boolean

스택 프레임의 파일 이름, 줄 번호 및 열 번호를 캡처하려면 true이고, 그렇지 않으면 false입니다.

예제

다음 예제에서는 사용 된 StackFrame(Boolean) 생성자입니다. 이 코드 예제는에 대해 제공 된 큰 예제의 일부는 StackFrame 클래스입니다.

[STAThread]
static void Main()
{
   ClassLevel1 ^ mainClass = gcnew ClassLevel1;
   try
   {
      mainClass->InternalMethod();
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( " Main method exception handler" );
      
      // Display file and line information, if available.
      StackTrace^ st = gcnew StackTrace( gcnew StackFrame( true ) );
      Console::WriteLine( " Stack trace for current level: {0}", st->ToString() );
      Console::WriteLine( " File: {0}", st->GetFrame( 0 )->GetFileName() );
      Console::WriteLine( " Line Number: {0}", st->GetFrame( 0 )->GetFileLineNumber().ToString() );
      Console::WriteLine();
      Console::WriteLine( "-------------------------------------------------\n" );
   }

}

[STAThread]
static void Main()
 {
     ClassLevel1 mainClass = new ClassLevel1();

     try {
         mainClass.InternalMethod();
     }
     catch (Exception) {
        Console.WriteLine(" Main method exception handler");

        // Display file and line information, if available.
        StackTrace st = new StackTrace(new StackFrame(true));
        Console.WriteLine(" Stack trace for current level: {0}",
            st.ToString());
        Console.WriteLine(" File: {0}",
           st.GetFrame(0).GetFileName());
        Console.WriteLine(" Line Number: {0}",
            st.GetFrame(0).GetFileLineNumber().ToString());

        Console.WriteLine();
        Console.WriteLine("-------------------------------------------------\n");
     }
 }

<STAThread()>  _
Shared Sub Main()
   Dim mainClass As New ClassLevel1
   
   Try
      mainClass.InternalMethod()
   Catch
      Console.WriteLine(" Main method exception handler")
      
      ' Display file and line information, if available.
      Dim st As New StackTrace(New StackFrame(True))
      Console.WriteLine(" Stack trace for current level: {0}", _
         st.ToString())
      Console.WriteLine(" File: {0}", _
         st.GetFrame(0).GetFileName())
      Console.WriteLine(" Line Number: {0}", _
         st.GetFrame(0).GetFileLineNumber().ToString())
      
      Console.WriteLine()
      Console.WriteLine("-------------------------------------------------")
      Console.WriteLine()
   End Try
End Sub

StackFrame(String, Int32)

Source:

StackFrame.cs

지정된 파일 이름과 줄 번호만 포함하는 StackFrame 클래스의 새 인스턴스를 초기화합니다.

public:
 StackFrame(System::String ^ fileName, int lineNumber);

public StackFrame (string? fileName, int lineNumber);

new System.Diagnostics.StackFrame : string * int -> System.Diagnostics.StackFrame

Public Sub New (fileName As String, lineNumber As Integer)

매개 변수

fileName

String

파일 이름입니다.

lineNumber

Int32

지정된 파일의 줄 번호입니다.

예제

다음 예제에서는 사용 된 StackFrame(String, Int32) 생성자입니다. 이 코드 예제는에 대해 제공 된 큰 예제의 일부는 StackFrame 클래스입니다.

void Level3Method()
{
   try
   {
      ClassLevel4^ nestedClass = gcnew ClassLevel4;
      nestedClass->Level4Method();
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( " Level3Method exception handler" );
      
      // Build a stack trace from a dummy stack frame.
      // Explicitly specify the source file name and line number.
      StackTrace^ st = gcnew StackTrace( gcnew StackFrame( "source.cs",60 ) );
      Console::WriteLine( " Stack trace with dummy stack frame: {0}", st->ToString() );
      for ( int i = 0; i < st->FrameCount; i++ )
      {
         
         // Display the stack frame properties.
         StackFrame^ sf = st->GetFrame( i );
         Console::WriteLine( " File: {0}", sf->GetFileName() );
         Console::WriteLine( " Line Number: {0}", sf->GetFileLineNumber().ToString() );
         
         // Note that the column number defaults to zero
         // when not initialized.
         Console::WriteLine( " Column Number: {0}", sf->GetFileColumnNumber().ToString() );
         Console::WriteLine( " Intermediate Language Offset: {0}", sf->GetILOffset().ToString() );
         Console::WriteLine( " Native Offset: {0}", sf->GetNativeOffset().ToString() );
         

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

}

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

      // Build a stack trace from a dummy stack frame.
      // Explicitly specify the source file name and
      // line number.
      StackTrace st = new StackTrace(new StackFrame("source.cs", 60));
      Console.WriteLine(" Stack trace with dummy stack frame: {0}",
                  st.ToString());
      for(int i =0; i< st.FrameCount; i++ )
      {
         // Display the stack frame properties.
         StackFrame sf = st.GetFrame(i);
         Console.WriteLine(" File: {0}", sf.GetFileName());
         Console.WriteLine(" Line Number: {0}",
            sf.GetFileLineNumber());
         // Note that the column number defaults to zero
         // when not initialized.
         Console.WriteLine(" Column Number: {0}",
            sf.GetFileColumnNumber());
         if (sf.GetILOffset() != StackFrame.OFFSET_UNKNOWN)
         {
            Console.WriteLine(" Intermediate Language Offset: {0}",
               sf.GetILOffset());
         }
         if (sf.GetNativeOffset() != StackFrame.OFFSET_UNKNOWN)
         {
            Console.WriteLine(" Native Offset: {0}",
               sf.GetNativeOffset());
         }
      }
      Console.WriteLine();
      Console.WriteLine("   ... throwing exception to next level ...");
      Console.WriteLine("-------------------------------------------------\n");
      throw e;
   }
}

Public Sub Level3Method()
   Try
      Dim nestedClass As New ClassLevel4()
      nestedClass.Level4Method()
   Catch e As Exception
      Console.WriteLine(" Level3Method exception handler")
      
      ' Build a stack trace from a dummy stack frame.
      ' Explicitly specify the source file name and line number.
      Dim st As New StackTrace(New StackFrame("source.cs", 60))
      Console.WriteLine(" Stack trace with dummy stack frame: {0}", _
         st.ToString())
      Dim i As Integer
      For i = 0 To st.FrameCount - 1
         ' Display the stack frame properties.
         Dim sf As StackFrame = st.GetFrame(i)
         Console.WriteLine(" File: {0}", sf.GetFileName())
         Console.WriteLine(" Line Number: {0}", _
            sf.GetFileLineNumber())
         ' The column number defaults to zero when not initialized.
         Console.WriteLine(" Column Number: {0}", _
            sf.GetFileColumnNumber())
         If sf.GetILOffset <> StackFrame.OFFSET_UNKNOWN
            Console.WriteLine(" Intermediate Language Offset: {0}", _
                sf.GetILOffset())
         End If
         If sf.GetNativeOffset <> StackFrame.OFFSET_UNKNOWN
           Console.WriteLine(" Native Offset: {0}", _
               sf.GetNativeOffset())
         End If
      Next i 
      Console.WriteLine()
      Console.WriteLine("   ... throwing exception to next level ...")
      Console.WriteLine("-------------------------------------------------")
      Console.WriteLine()
      Throw e
   End Try
End Sub

설명

디버거의 줄 매핑 논리를 사용하지 않으려면 이 생성자를 사용합니다.

StackFrame(Int32, Boolean)

Source:

StackFrame.cs

필요에 따라 소스 정보를 캡처하고 현재 스택 프레임 위의 프레임에 해당하는 StackFrame 클래스의 새 인스턴스를 초기화합니다.

public:
 StackFrame(int skipFrames, bool needFileInfo);

public StackFrame (int skipFrames, bool needFileInfo);

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

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

매개 변수

skipFrames

Int32

건너뛸 스택 프레임의 개수입니다.

needFileInfo

Boolean

스택 프레임의 파일 이름, 줄 번호 및 열 번호를 캡처하려면 true이고, 그렇지 않으면 false입니다.

예제

다음 예제에서는 사용 된 StackFrame(Int32, Boolean) 생성자입니다. 이 코드 예제는에 대해 제공 된 큰 예제의 일부는 StackFrame 클래스입니다.

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

StackFrame(String, Int32, Int32)

Source:

StackFrame.cs

지정된 파일 이름, 줄 번호 및 열 번호만 포함하는 StackFrame 클래스의 새 인스턴스를 초기화합니다.

public:
 StackFrame(System::String ^ fileName, int lineNumber, int colNumber);

public StackFrame (string? fileName, int lineNumber, int colNumber);

new System.Diagnostics.StackFrame : string * int * int -> System.Diagnostics.StackFrame

Public Sub New (fileName As String, lineNumber As Integer, colNumber As Integer)

매개 변수

fileName

String

파일 이름입니다.

lineNumber

Int32

지정된 파일의 줄 번호입니다.

colNumber

Int32

지정된 파일의 열 번호입니다.

예제

다음 예제에서는 사용 된 StackFrame 생성자입니다. 이 코드 예제는에 대해 제공 된 큰 예제의 일부는 StackFrame 클래스입니다.

try
{
   ClassLevel5^ nestedClass = gcnew ClassLevel5;
   nestedClass->Level5Method();
}
catch ( Exception^ e ) 
{
   Console::WriteLine( " Level4Method exception handler" );
   
   // Build a stack trace from a dummy stack frame.
   // Explicitly specify the source file name, line number
   // and column number.
   StackTrace^ st = gcnew StackTrace( gcnew StackFrame( "source.cs",79,24 ) );
   Console::WriteLine( " Stack trace with dummy stack frame: {0}", st->ToString() );
   
   // Access the StackFrames explicitly to display the file
   // name, line number and column number properties.
   // StackTrace.ToString only includes the method name. 
   for ( int i = 0; i < st->FrameCount; i++ )
   {
      StackFrame^ sf = st->GetFrame( i );
      Console::WriteLine( " File: {0}", sf->GetFileName() );
      Console::WriteLine( " Line Number: {0}", sf->GetFileLineNumber().ToString() );
      Console::WriteLine( " Column Number: {0}", sf->GetFileColumnNumber().ToString() );

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

try
{
   ClassLevel5 nestedClass = new ClassLevel5();
   nestedClass.Level5Method();
}
catch (Exception e)
{
   Console.WriteLine(" Level4Method exception handler");

   // Build a stack trace from a dummy stack frame.
   // Explicitly specify the source file name, line number
   // and column number.
   StackTrace st = new StackTrace(new StackFrame("source.cs", 79, 24));
   Console.WriteLine(" Stack trace with dummy stack frame: {0}",
                  st.ToString());

   // Access the StackFrames explicitly to display the file
   // name, line number and column number properties.
   // StackTrace.ToString only includes the method name.
   for(int i =0; i< st.FrameCount; i++ )
   {
      StackFrame sf = st.GetFrame(i);
      Console.WriteLine(" File: {0}", sf.GetFileName());
      Console.WriteLine(" Line Number: {0}",
         sf.GetFileLineNumber());
      Console.WriteLine(" Column Number: {0}",
         sf.GetFileColumnNumber());
   }
   Console.WriteLine();
   Console.WriteLine("   ... throwing exception to next level ...");
   Console.WriteLine("-------------------------------------------------\n");
   throw e;
}

   Try
      Dim [nestedClass] As New ClassLevel5()
      [nestedClass].Level5Method()
   Catch e As Exception
      Console.WriteLine(" Level4Method exception handler")
      
      ' Build a stack trace from a dummy stack frame.
      ' Explicitly specify the source file name, line number
      ' and column number.
      Dim st As New StackTrace(New StackFrame("source.cs", 79, 24))
      Console.WriteLine(" Stack trace with dummy stack frame: {0}", _
         st.ToString())
      
      ' Access the StackFrames explicitly to display the file
      ' name, line number and column number properties.
      ' StackTrace.ToString only includes the method name. 
      Dim i As Integer
      For i = 0 To st.FrameCount - 1
         Dim sf As StackFrame = st.GetFrame(i)
         Console.WriteLine(" File: {0}", sf.GetFileName())
         Console.WriteLine(" Line Number: {0}", _
            sf.GetFileLineNumber())
         Console.WriteLine(" Column Number: {0}", _
            sf.GetFileColumnNumber())
      Next i
      Console.WriteLine()
      Console.WriteLine("   ... throwing exception to next level ...")
      Console.WriteLine("-------------------------------------------------")
      Console.WriteLine()
      Throw e
   End Try
End Sub

설명

디버거의 줄 매핑 논리를 사용하지 않으려면 이 생성자를 사용합니다.