ExceptionDispatchInfo.SetRemoteStackTrace(Exception, String) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Runtime.ExceptionServices

Zestaw:: System.Runtime.dll

Źródło:: ExceptionDispatchInfo.cs

Źródło:: ExceptionDispatchInfo.cs

Źródło:: ExceptionDispatchInfo.cs

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Przechowuje podany ślad stosu w określonym Exception wystąpieniu.

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

Nierownowy wyjątek.

stackTrace: String

Ciąg śledzenia stosu do utrwalania w obiekcie source. Jest to zwykle uzyskiwane z StackTrace właściwości wystąpienia wyjątku zdalnego.

Zwraca

Exception

Wystąpienie wyjątku source .

Wyjątki

ArgumentNullException

Argument source or stackTrace to null.

InvalidOperationException

Argument source został wcześniej zgłoszony lub wcześniej miał przechowywany ślad stosu.

Uwagi

Ta metoda wypełnia StackTrace właściwość z dowolnej wartości ciągu. Typowy przypadek użycia polega na transmisji Exception obiektów między procesami o wysokiej wierności, co umożliwia zachowanie informacji śledzenia stosu obiektu wyjątku. Platforma .NET nie próbuje przeanalizować podanej wartości ciągu.

Obiekt wywołujący jest odpowiedzialny za kanoniczne zakończenia wierszy, jeśli jest to wymagane. ReplaceLineEndings() może służyć do kanonicznego kończenia linii.

Jeśli obiekt wywołujący dostarcza niezaufane dane wejściowe do tego interfejsu API, może to spowodować, że ślad stosu wyjątku zawierający osadzone znaki null, zastrzeżone znaki HTML lub JSON lub inne nieoczekiwane wartości. Aplikacje, które wyświetlają szczegóły wyjątku dla użytkownika, powinny zawsze dbać o kodowanie informacji o wyjątku w momencie jego wyświetlania.

Dotyczy

Udostępnij za pośrednictwem