ExceptionDispatchInfo.SetRemoteStackTrace(Exception, String) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
Instancia de source
excepción.
Excepciones
El source
argumento o stackTrace
era null
.
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.