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

Ссылка

Определение

Пространство имен:: System.Runtime.ExceptionServices

Сборка:: System.Runtime.dll

Исходный код:: ExceptionDispatchInfo.cs

Исходный код:: ExceptionDispatchInfo.cs

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

Применяется к

Поделиться через