ExceptionDispatchInfo.SetRemoteStackTrace(Exception, String) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 -> ExceptionPublic Shared Function SetRemoteStackTrace (source As Exception, stackTrace As String) As ExceptionParamè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 source instance.
Exceptions
L’argument source ou stackTrace était null.
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.
