ExceptionDispatchInfo.SetRemoteStackTrace(Exception, String) 方法

定义

命名空间:

System.Runtime.ExceptionServices

程序集:

System.Runtime.dll

Source:

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

未引发的异常。

stackTrace

String

要保留在 中的 source堆栈跟踪字符串。 这通常是从 StackTrace 远程异常实例的 属性获取的。

返回

Exception

source异常实例。

例外

ArgumentNullException

source或 stackTrace 参数为 null。

InvalidOperationException

该 source 参数以前已引发，或者以前存储了堆栈跟踪。

注解

此方法从任意字符串值填充 StackTrace 属性。 典型的用例是以高保真度跨进程传输 Exception 对象，从而允许保留异常对象的堆栈跟踪信息。 .NET 不会尝试分析提供的字符串值。

如果需要，调用方负责规范化行尾。 ReplaceLineEndings() 可用于规范行尾。

如果调用方为此 API 提供不受信任的输入，则可能会导致异常的堆栈跟踪包含嵌入的 null 字符、保留的 HTML 或 JSON 字符或其他意外值。 向用户显示异常详细信息的应用程序应始终注意在异常信息的显示位置对异常信息进行编码。