Environment.StackTrace プロパティ

定義

現在のスタック トレース情報を取得します。Gets current stack trace information.

public:
 static property System::String ^ StackTrace { System::String ^ get(); };
public static string StackTrace { get; }
member this.StackTrace : string
Public Shared ReadOnly Property StackTrace As String

プロパティ値

スタック トレース情報を格納している文字列。A string containing stack trace information. この値は、Empty の場合もあります。This value can be Empty.

次の例は、StackTrace プロパティを示しています。The following example demonstrates the StackTrace property.

// Sample for the Environment::StackTrace property
using namespace System;
int main()
{
   Console::WriteLine();
   Console::WriteLine( "StackTrace: ' {0}'", Environment::StackTrace );
}

/*
This example produces the following results:

StackTrace: '   at System::Environment::GetStackTrace(Exception e)
at System::Environment::GetStackTrace(Exception e)
at System::Environment::get_StackTrace()
at Sample::Main()'
*/
// Sample for the Environment.StackTrace property
using System;

class Sample 
{
    public static void Main() 
    {
    Console.WriteLine();
    Console.WriteLine("StackTrace: '{0}'", Environment.StackTrace);
    }
}
/*
This example produces the following results:

StackTrace: '   at System.Environment.GetStackTrace(Exception e)
   at System.Environment.GetStackTrace(Exception e)
   at System.Environment.get_StackTrace()
   at Sample.Main()'
*/
' Sample for the Environment.StackTrace property
Class Sample
   Public Shared Sub Main()
      Console.WriteLine()
      Console.WriteLine("StackTrace: '{0}'", Environment.StackTrace)
   End Sub
End Class
'
'This example produces the following results:
'
'StackTrace: '   at System.Environment.GetStackTrace(Exception e)
'   at System.Environment.GetStackTrace(Exception e)
'   at System.Environment.get_StackTrace()
'   at Sample.Main()'
'

注釈

@No__t-0 プロパティは、メソッドの呼び出しを時系列の逆の順序で一覧表示します。つまり、最後のメソッド呼び出しが最初に記述され、スタックのメソッド呼び出しごとに1行のスタックトレース情報が一覧表示されます。The StackTrace property lists method calls in reverse chronological order, that is, the most recent method call is described first, and one line of stack trace information is listed for each method call on the stack. ただし、StackTrace プロパティでは、最適化中に発生するコード変換によって、予想どおりに多くのメソッド呼び出しが報告されない場合があります。However, the StackTrace property might not report as many method calls as expected due to code transformations that occur during optimization.

注意

クラス別のスタックトレース情報の階層ビューを表示するには、StackTrace クラスを使用します。For a hierarchical view of the stack trace information by class, use the StackTrace class.

@No__t-0 プロパティは、各メソッド呼び出しのスタックトレース情報を次のように書式設定します。The StackTrace property formats the stack trace information for each method call as follows:

"FullClassName. MethodName (MethodParams) (FileName: 行 LineNumber")"at FullClassName.MethodName(MethodParams) in FileName :line LineNumber "

リテラルの "at" の前には3つのスペースが付きます。デバッグシンボルを使用できない場合は、"in" で始まる部分文字列全体が省略されます。The literal "at" is preceded by three spaces, and the entire substring starting with "in" is omitted if debug symbols are not available. プレースホルダー、FullClassNameMethodNameMethodParamsFileNameLineNumber が実際の値に置き換えられ、次のように定義されます。The placeholders, FullClassName, MethodName, MethodParams, FileName, and LineNumber, are replaced by actual values, and are defined as follows:

FullClassNameFullClassName
名前空間を含むクラスの完全名。The full name of the class, including the namespace.

MethodName
メソッドの名前。The name of the method.

MethodParams
パラメーターの型と名前のペアの一覧。The list of parameter type/name pairs. 各ペアはコンマ (",") で区切られます。Each pair is separated by a comma (","). @No__t-0 がパラメーターを受け取らない場合、この情報は省略されます。This information is omitted if MethodName takes no parameters.

FileName
@No__t-0 メソッドが宣言されているソースファイルの名前。The name of the source file where the MethodName method is declared. デバッグシンボルを使用できない場合、この情報は省略されます。This information is omitted if debug symbols are not available.

LineNumber
呼び出し履歴にある命令について MethodName のソースコードを含む FileName の行の番号。The number of the line in FileName that contains the source code from MethodName for the instruction that is on the call stack. デバッグシンボルを使用できない場合、この情報は省略されます。This information is omitted if debug symbols are not available.

@No__t 0 の文字列は、スタックトレースの各行を終了します。The Environment.NewLine string terminates each line of the stack trace.

セキュリティ

EnvironmentPermission
アクセス許可によって保護されているリソースへのフルアクセスの場合。for full access to the resource protected by the permission. 関連付けられた列挙型: UnrestrictedAssociated enumeration: Unrestricted

適用対象