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

未擲回的例外狀況。

stackTrace

String

要保存在內的 source堆疊追蹤字串。 這通常是從 StackTrace 遠端例外狀況實例的 屬性取得。

傳回

Exception

source例外狀況實例。

例外狀況

ArgumentNullException

source或 stackTrace 自變數為 null。

InvalidOperationException

自 source 變數先前已擲回，或先前已將堆疊追蹤儲存到其中。

備註

這個方法會 StackTrace 從任意字串值填入 屬性。 典型的使用案例是透過高精確度跨進程傳輸 Exception 對象，允許保留例外狀況物件的堆疊追蹤資訊。 .NET 不會嘗試剖析提供的字串值。

呼叫端負責視需要規範化行尾端。 ReplaceLineEndings() 可以用來標準行尾端。

如果呼叫端為此 API 提供不受信任的輸入，這可能會導致例外狀況的堆疊追蹤包含內嵌 Null 字元、保留的 HTML 或 JSON 字元，或其他未預期的值。 向使用者顯示例外狀況詳細數據的應用程式應該一律小心編碼其顯示位置的例外狀況資訊。