ExceptionDispatchInfo.SetRemoteStackTrace(Exception, String) メソッド

定義

名前空間:

System.Runtime.ExceptionServices

アセンブリ:

System.Runtime.dll

ソース:

ExceptionDispatchInfo.cs

指定されたスタック トレースを指定した Exception インスタンスに格納します。

public:
 static Exception ^ SetRemoteStackTrace(Exception ^ source, System::String ^ stackTrace);

public static Exception SetRemoteStackTrace (Exception source, string stackTrace);

static member SetRemoteStackTrace : Exception * string -> Exception

Public Shared Function SetRemoteStackTrace (source As Exception, stackTrace As String) As Exception

パラメーター

source

Exception

unthrown 例外。

stackTrace

String

内 sourceに保持するスタック トレース文字列。 これは通常、リモート例外インスタンスの StackTrace プロパティから取得されます。

戻り値

Exception

source例外インスタンス。

例外

ArgumentNullException

または stackTrace 引数は source ですnull。

InvalidOperationException

引数は source 以前にスローされたか、以前にスタック トレースが格納されていました。

注釈

このメソッドは、任意の StackTrace 文字列値から プロパティを設定します。 一般的なユース ケースは、忠実度の高いプロセス間でのオブジェクトの Exception 転送であり、例外オブジェクトのスタック トレース情報を保持できます。 .NET では、指定された文字列値の解析は試行されません。

呼び出し元は、必要に応じて行末を正規化する必要があります。 ReplaceLineEndings() を使用して、行末を正規化できます。

呼び出し元がこの API に信頼されていない入力を提供すると、埋め込まれた null 文字、予約済み HTML または JSON 文字、またはその他の予期しない値を含む例外のスタック トレースが発生する可能性があります。 例外の詳細をユーザーに表示するアプリケーションでは、常に例外情報が表示される時点でエンコードするように注意する必要があります。