ExceptionDispatchInfo.SetRemoteStackTrace(Exception, String) Metoda

Definice

Obor názvů:

System.Runtime.ExceptionServices

Sestavení:

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

Výjimka unthrown.

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

Argument source nebo stackTrace byl null.

InvalidOperationException

Argument source byl dříve vyvolán nebo do něj bylo uloženo trasování zásobníku.

Poznámky

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

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

Pokud volající poskytne pro toto rozhraní API nedůvěryhodný vstup, může to vést k tomu, že trasování zásobníku výjimky obsahuje vložené znaky null, vyhrazené znaky HTML nebo JSON nebo jiné neočekávané hodnoty. Aplikace, které uživateli zobrazují podrobnosti o výjimce, by měly vždy dbát na to, aby informace o výjimce kódovaly v místě, kde se zobrazí.