ExceptionDispatchInfo.SetRemoteStackTrace(Exception, String) Metod

Definition

Lagrar den angivna stackspårningen i den angivna Exception instansen.

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

Parametrar

source
Exception

Det inåtväxade undantaget.

stackTrace
String

Stackspårningssträngen som ska sparas i source. Detta hämtas normalt från StackTrace egenskapen för fjärrfelinstansen.

Returer

Undantagsinstansen source .

Undantag

Argumentet source eller stackTrace var null.

Argumentet source kastades tidigare eller hade tidigare en stackspårning lagrad i den.

Kommentarer

Den här metoden fyller egenskapen från StackTrace ett godtyckligt strängvärde. Det vanliga användningsfallet är överföring av Exception objekt mellan processer med hög återgivning, vilket gör det möjligt att bevara undantagsobjektets stackspårningsinformation. .NET försöker inte parsa det angivna strängvärdet.

Anroparen ansvarar för kanonisering av radslut om det behövs. ReplaceLineEndings() kan användas för att kanonisera radslut.

Om anroparen tillhandahåller ej betrodda indata till det här API:et kan det resultera i undantagets stackspårning som innehåller inbäddade null-tecken, reserverade HTML- eller JSON-tecken eller andra oväntade värden. Program som visar information om ett undantag för användaren bör alltid vara noga med att koda undantagsinformationen vid den punkt där den visas.

Gäller för