Edit

StackFrame.GetFileName Method

  • Reference

Definition

Namespace:
System.Diagnostics
Assemblies:
mscorlib.dll, System.Diagnostics.StackTrace.dll
Assembly:
System.Diagnostics.StackTrace.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Source:
StackFrame.cs
Source:
StackFrame.cs
Source:
StackFrame.cs

Gets the file name that contains the code that is executing. This information is typically extracted from the debugging symbols for the executable.

public:
 System::String ^ GetFileName();
public:
 virtual System::String ^ GetFileName();
public string GetFileName ();
public virtual string? GetFileName ();
public virtual string GetFileName ();
member this.GetFileName : unit -> string
abstract member GetFileName : unit -> string
override this.GetFileName : unit -> string
Public Function GetFileName () As String
Public Overridable Function GetFileName () As String

Returns

String

The file name, or null if the file name cannot be determined.

Examples

The following example demonstrates the use of the GetFileName method. This code example is part of a larger example provided for the StackFrame class.

// 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() );

// 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());
}

' 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

Applies to