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 sem crescimento.
- stackTrace
- String
A cadeia de caracteres de rastreamento de pilha a ser mantida dentro source. Normalmente, isso é adquirido da StackTrace propriedade da instância de exceção remota.
Retornos
A instância de source exceção.
Exceções
O source argumento ou stackTrace foi 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 de cadeia de caracteres arbitrário. 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. .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 uma 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 sempre devem ter cuidado para codificar as informações de exceção no ponto em que ela é exibida.
