ExceptionDispatchInfo.SetRemoteStackTrace(Exception, String) Método

Definición

Espacio de nombres:

System.Runtime.ExceptionServices

Ensamblado:

System.Runtime.dll

Source:

ExceptionDispatchInfo.cs

Almacena el seguimiento de pila proporcionado en la instancia especificada 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

Parámetros

source

Exception

Excepción no emitida.

stackTrace

String

Cadena de seguimiento de pila que se va a conservar en source. Normalmente, esto se adquiere a partir de la StackTrace propiedad de la instancia de excepción remota.

Devoluciones

Exception

Instancia de source excepción.

Excepciones

ArgumentNullException

El source argumento o stackTrace era null.

InvalidOperationException

El source argumento se produjo anteriormente o anteriormente tenía un seguimiento de pila almacenado en él.

Comentarios

Este método rellena la StackTrace propiedad de un valor de cadena arbitrario. El caso de uso típico es la transmisión de Exception objetos entre procesos con alta fidelidad, lo que permite la conservación de la información de seguimiento de la pila del objeto de excepción. .NET no intenta analizar el valor de cadena proporcionado.

El autor de la llamada es responsable de canónicos finales de línea si es necesario. ReplaceLineEndings() se puede usar para canónicos finales de línea.

Si el autor de la llamada proporciona una entrada que no es de confianza para esta API, esto puede provocar el seguimiento de la pila de la excepción que contiene caracteres NULL incrustados, caracteres HTML reservados o JSON, u otros valores inesperados. Las aplicaciones que muestran los detalles de una excepción al usuario siempre deben tener cuidado de codificar la información de excepción en el momento en que se muestra.