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

定義

指定したスタック トレースを、指定した 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 プロパティから取得されます。

返品

source例外インスタンス。

例外

sourceまたはstackTrace引数がnullされました。

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

注釈

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

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

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

適用対象