ExceptionDispatchInfo.SetRemoteStackTrace(Exception, String) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
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.