ExceptionDispatchInfo.SetRemoteStackTrace(Exception, String) Método

Definição

Namespace:

System.Runtime.ExceptionServices

Assembly:

System.Runtime.dll

Origem:

ExceptionDispatchInfo.cs

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 -> Exception

Public Shared Function SetRemoteStackTrace (source As Exception, stackTrace As String) As Exception

Parâ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

Exception

A source instância de exceção.

Exceções

ArgumentNullException

O source argumento ou stackTrace era null.

InvalidOperationException

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.