ExceptionDispatchInfo.SetRemoteStackTrace(Exception, String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Armazena o rastreamento 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 gerada.
- stackTrace
- String
A cadeia de caracteres de rastreamento de pilha a persistir dentro sourcede . Normalmente, isso é adquirido da StackTrace propriedade da instância de exceção remota.
Retornos
A source instância de exceção.
Exceções
O source argumento ou stackTrace era null.
O source argumento foi lançado anteriormente ou anteriormente tinha um rastreamento de pilha armazenado nele.
Comentários
Esse método preenche a StackTrace propriedade de um valor arbitrário de cadeia de caracteres. O caso de uso típico é a transmissão de Exception objetos entre processos com alta fidelidade, permitindo a preservação das informações de rastreamento de pilha do objeto de exceção. O .NET não tenta analisar o valor de cadeia de caracteres fornecido.
O chamador é responsável por canonizar terminações de linha, se necessário. ReplaceLineEndings() pode ser usado para canonizar terminações de linha.
Se o chamador fornecer entrada não confiável para essa API, isso poderá resultar no rastreamento de pilha da exceção que contém caracteres nulos inseridos, caracteres HTML ou JSON reservados ou outros valores inesperados. Os aplicativos que exibem os detalhes de uma exceção para o usuário devem sempre ter o cuidado de codificar as informações de exceção no ponto em que ela é exibida.
