ExceptionDispatchInfo.SetRemoteStackTrace(Exception, String) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Speichert die bereitgestellte Stapelüberwachung in der angegebenen Exception instance.
public:
static Exception ^ SetRemoteStackTrace(Exception ^ source, System::String ^ stackTrace);public static Exception SetRemoteStackTrace (Exception source, string stackTrace);static member SetRemoteStackTrace : Exception * string -> ExceptionPublic Shared Function SetRemoteStackTrace (source As Exception, stackTrace As String) As ExceptionParameter
- source
- Exception
Die nicht ausgelöste Ausnahme.
- stackTrace
- String
Die Stapelablaufverfolgungszeichenfolge, die in sourcebeibehalten werden soll. Dies wird normalerweise von der StackTrace -Eigenschaft der Remote-Ausnahme instance abgerufen.
Gibt zurück
Die source Ausnahme instance.
Ausnahmen
Das source - oder stackTrace -Argument lautete null.
Das source Argument wurde zuvor ausgelöst oder hatte zuvor eine Stapelüberwachung darin gespeichert.
Hinweise
Diese Methode füllt die StackTrace -Eigenschaft aus einem beliebigen Zeichenfolgenwert auf. Der typische Anwendungsfall ist die Übertragung von Exception Objekten über Prozesse mit hoher Genauigkeit, sodass die Stapelüberwachungsinformationen des Ausnahmeobjekts beibehalten werden. .NET versucht nicht, den angegebenen Zeichenfolgenwert zu analysieren.
Der Aufrufer ist für die Kanonisierung von Zeilenenden bei Bedarf verantwortlich. ReplaceLineEndings() kann verwendet werden, um Zeilenenden zu kanonisieren.
Wenn der Aufrufer nicht vertrauenswürdige Eingaben für diese API bereitstellt, kann dies dazu führen, dass die Stapelablaufverfolgung der Ausnahme eingebettete NULL-Zeichen, reservierte HTML- oder JSON-Zeichen oder andere unerwartete Werte enthält. Anwendungen, die dem Benutzer die Details einer Ausnahme anzeigen, sollten immer darauf achten, die Ausnahmeinformationen an dem Punkt zu codieren, an dem sie angezeigt werden.
