ExceptionDispatchInfo.SetRemoteStackTrace(Exception, String) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Archivia l'analisi dello stack fornita nell'istanza specificata Exception .
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 ExceptionParametri
- source
- Exception
Eccezione non generata.
- stackTrace
- String
Stringa di analisi dello stack da rendere persistente all'interno sourcedi . Questa operazione viene in genere acquisita dalla StackTrace proprietà dell'istanza di eccezione remota.
Restituisce
Istanza dell'eccezione source .
Eccezioni
L'argomento source o stackTrace è .null
L'argomento source è stato generato in precedenza o in precedenza era archiviato in un'analisi dello stack.
Commenti
Questo metodo popola la StackTrace proprietà da un valore stringa arbitrario. Il caso d'uso tipico è la trasmissione di Exception oggetti tra processi con alta fedeltà, consentendo la conservazione delle informazioni di analisi dello stack dell'oggetto eccezione. .NET non tenta di analizzare il valore stringa specificato.
Se necessario, il chiamante è responsabile della canonizzazione delle terminazioni di riga. ReplaceLineEndings() può essere utilizzato per canonizzare le terminazioni di riga.
Se il chiamante fornisce input non attendibile per questa API, questo può comportare l'analisi dello stack dell'eccezione contenente caratteri Null incorporati, caratteri HTML o JSON riservati o altri valori imprevisti. Le applicazioni che visualizzano i dettagli di un'eccezione all'utente devono sempre prestare attenzione alla codifica delle informazioni sull'eccezione nel punto in cui viene visualizzata.
