ExceptionDispatchInfo.SetRemoteStackTrace(Exception, String) Metoda

Definice

Obor názvů:

System.Runtime.ExceptionServices

Sestavení:

netstandard.dll, System.Runtime.dll

Zdroj:

ExceptionDispatchInfo.cs

Uloží zadané trasování zásobníku do zadané Exception instance.

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

Parametry

source

Exception

Nezvětšovat výjimku.

stackTrace

String

Řetězec trasování zásobníku, který se má zachovat v rámci source. Obvykle se získává z StackTrace vlastnosti instance vzdálené výjimky.

Návraty

Exception

Instance source výjimky.

Výjimky

ArgumentNullException

stackTrace Argument source byl null.

InvalidOperationException

Argument source byl dříve vyvolán nebo dříve obsahoval trasování zásobníku uložené v něm.

Poznámky

Tato metoda naplní StackTrace vlastnost z libovolné řetězcové hodnoty. Typickým případem použití je přenos Exception objektů napříč procesy s vysokou věrností, což umožňuje zachování informací o trasování zásobníku objektu výjimky. .NET se nepokoušá analyzovat zadanou řetězcovou hodnotu.

Volající v případě potřeby zodpovídá za kanonizaci koncovek řádků. ReplaceLineEndings() lze použít k kanonizaci zakončení čar.

Pokud volající poskytuje nedůvěryhodný vstup pro toto rozhraní API, může to vést k tomu, že trasování zásobníku výjimky obsahuje vložené znaky null, rezervované znaky HTML nebo JSON nebo jiné neočekávané hodnoty. Aplikace, které uživateli zobrazují podrobnosti o výjimce, by se vždy měly postarat o kódování informací o výjimce v okamžiku, kdy se zobrazí.