ExceptionDispatchInfo.SetRemoteStackTrace(Exception, String) Méthode

Définition

Espace de noms:

System.Runtime.ExceptionServices

Assembly:

System.Runtime.dll

Source:

ExceptionDispatchInfo.cs

Stocke la trace de pile fournie dans le instance spécifié 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

Paramètres

source

Exception

Exception non générée.

stackTrace

String

Chaîne de trace de pile à conserver dans source. Cela est normalement acquis à partir de la StackTrace propriété de l’exception distante instance.

Retours

Exception

Exception source instance.

Exceptions

ArgumentNullException

L’argument source ou stackTrace était null.

InvalidOperationException

L’argument source a été précédemment levée ou avait précédemment une trace de pile stockée dans celui-ci.

Remarques

Cette méthode remplit la StackTrace propriété à partir d’une valeur de chaîne arbitraire. Le cas d’usage classique est la transmission d’objets Exception entre des processus avec une haute fidélité, ce qui permet de conserver les informations de trace de la pile de l’objet d’exception. .NET ne tente pas d’analyser la valeur de chaîne fournie.

L’appelant est responsable de la canonisation des terminaisons de ligne si nécessaire. ReplaceLineEndings() peut être utilisé pour canonicaliser les terminaisons de ligne.

Si l’appelant fournit une entrée non approuvée à cette API, la trace de pile de l’exception peut contenir des caractères null incorporés, des caractères HTML ou JSON réservés ou d’autres valeurs inattendues. Les applications qui affichent les détails d’une exception à l’utilisateur doivent toujours veiller à encoder les informations d’exception au point où elles sont affichées.