ExceptionDispatchInfo.SetRemoteStackTrace(Exception, String) Methode

Referenz

Definition

Namespace:: System.Runtime.ExceptionServices

Assemblys:: netstandard.dll, System.Runtime.dll

Quelle:: ExceptionDispatchInfo.cs

Quelle:: ExceptionDispatchInfo.cs

Quelle:: ExceptionDispatchInfo.cs

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 -> 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

Exception

Die source Ausnahme instance.

Ausnahmen

ArgumentNullException

Das source - oder stackTrace -Argument lautete null.

InvalidOperationException

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:

Produkt	Versionen
.NET	6, 7, 8, 9, 10

Teilen über