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