ExceptionDispatchInfo.SetRemoteStackTrace(Exception, String) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Armazena o rastreio de pilha fornecido na instância especificada 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 ExceptionParâmetros
- source
- Exception
A exceção não lançada.
- stackTrace
- String
A pilha traça a cadeia para persistir dentro sourcede . Isto é normalmente adquirido a partir da StackTrace propriedade da instância de exceção remota.
Devoluções
A source exceção.
Exceções
O source argumento de ou stackTrace era null.
O source argumento já tinha sido lançado anteriormente ou tinha um stack trace armazenado.
Observações
Este método preenche a StackTrace propriedade a partir de um valor de cadeia arbitrário. O caso de uso típico é a transmissão de objetos através de Exception processos com alta fidelidade, permitindo a preservação da informação de rastreio da pilha do objeto exceção. .NET não tenta analisar o valor da cadeia fornecido.
O chamador é responsável por canonizar as terminações das linhas, se necessário. ReplaceLineEndings() pode ser usado para canonizar terminações de linha.
Se o chamador fornecer entrada não confiável para esta API, isso pode resultar no rastreio de pilha da exceção contendo caracteres nulos incorporados, caracteres HTML ou JSON reservados, ou outros valores inesperados. As aplicações que mostram os detalhes de uma exceção ao utilizador devem sempre ter o cuidado de codificar a informação da exceção no ponto onde é apresentada.
