ExceptionDispatchInfo.SetRemoteStackTrace(Exception, String) Метод

Определение

Пространство имен:

System.Runtime.ExceptionServices

Сборки:

netstandard.dll, 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, это может привести к трассировке стека исключения, содержащей внедренные пустые символы, зарезервированные символы HTML или JSON или другие непредвиденные значения. Приложения, отображающие сведения об исключении для пользователя, всегда должны заботиться о кодировании сведений об исключении в точке его отображения.