ExceptionDispatchInfo.SetRemoteStackTrace(Exception, String) Metodo

Definizione

Spazio dei nomi:

System.Runtime.ExceptionServices

Assembly:

System.Runtime.dll

Origine:

ExceptionDispatchInfo.cs

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

Public Shared Function SetRemoteStackTrace (source As Exception, stackTrace As String) As Exception

Parametri

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

Exception

Istanza dell'eccezione source .

Eccezioni

ArgumentNullException

L'argomento source o stackTrace è .null

InvalidOperationException

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.