Freigeben über


ExceptionDispatchInfo.SetRemoteStackTrace(Exception, String) Methode

Definition

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 -> Exception
Public Shared Function SetRemoteStackTrace (source As Exception, stackTrace As String) As Exception

Parameter

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.

Gilt für: