StackFrame Class
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Provides information about a stack frame, which represents a function call on the call stack for the current thread.
Assembly: mscorlib (in mscorlib.dll)
The StackFrame type exposes the following members.
| Name | Description | |
|---|---|---|
 | StackFrame() | Initializes a new instance of the StackFrame class. |
| StackFrame(Boolean) | Security Critical. Initializes a new instance of the StackFrame class, and optionally captures source information. |
| StackFrame(Int32) | Initializes a new instance of the StackFrame class that corresponds to a frame above the current stack frame. |
| StackFrame(Int32, Boolean) | Security Critical. Initializes a new instance of the StackFrame class that corresponds to a frame above the current stack frame, and optionally captures source information. |
| StackFrame(String, Int32) | Initializes a new instance of the StackFrame class that contains only the specified file name and line number. |
| StackFrame(String, Int32, Int32) | Initializes a new instance of the StackFrame class that contains only the specified file name, line number, and column number. |
| Name | Description | |
|---|---|---|
| Equals(Object) | Determines whether the specified Object is equal to the current Object. (Inherited from Object.) |
 | Finalize | Allows an object to try to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.) |
| GetFileColumnNumber | Gets the column number in the file that contains the code that is executing. This information is typically extracted from the debugging symbols for the executable. |
| GetFileLineNumber | Gets the line number in the file that contains the code that is executing. This information is typically extracted from the debugging symbols for the executable. |
| GetFileName | Security Critical. Gets the file name that contains the code that is executing. This information is typically extracted from the debugging symbols for the executable. |
| GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
| GetILOffset | Gets the offset from the start of the Microsoft intermediate language (MSIL) code for the method that is executing. This offset might be an approximation depending on whether the just-in-time (JIT) compiler is generating debugging code. The generation of this debugging information is controlled by the DebuggableAttribute attribute. |
| GetMethod | Gets the method in which the frame is executing. |
| GetNativeOffset | Gets the offset from the start of the native just-in-time (JIT) compiled code for the method that is being executed. The generation of this debugging information is controlled by the DebuggableAttribute class. |
| GetType | Gets the Type of the current instance. (Inherited from Object.) |
| MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
| ToString | Builds a readable representation of the stack frame. (Overrides Object::ToString().) |
| Name | Description | |
|---|---|---|
  | OFFSET_UNKNOWN | Defines the value that is returned from the GetNativeOffset or GetILOffset method when the native or Microsoft intermediate language (MSIL) offset is unknown. This field is constant. |
A StackFrame object is created and pushed on the call stack for every function call that is made during the execution of a thread. The stack frame always includes MethodBase information, and optionally includes file name, line number, and column number information.
StackFrame information will be most informative with debug build configurations. By default, debug builds include debug symbols, but release builds do not. The debug symbols contain most of the file, method name, line number, and column information that is used in constructing StackFrame objects.
Version Notes
Windows Phone
StackFrame is not supported in Windows Phone.