DiagnosticSource.OnActivityExport(Activity, Object) 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.
Transfère l’état d’une activité à un événement ou une opération, comme une requête HTTP sortante, qui se produit en dehors du processus.
public:
virtual void OnActivityExport(System::Diagnostics::Activity ^ activity, System::Object ^ payload);public virtual void OnActivityExport (System.Diagnostics.Activity activity, object? payload);public virtual void OnActivityExport (System.Diagnostics.Activity activity, object payload);abstract member OnActivityExport : System.Diagnostics.Activity * obj -> unit
override this.OnActivityExport : System.Diagnostics.Activity * obj -> unitPublic Overridable Sub OnActivityExport (activity As Activity, payload As Object)Paramètres
- activity
- Activity
Activité affectée par un événement externe.
- payload
- Object
Objet qui représente la requête sortante.
Remarques
Si un site d’instrumentation se trouve à un emplacement où les activités quittent le processus (par exemple, les requêtes HTTP sortantes), ce site souhaite transférer l’état de l’activité vers la requête sortante.
Dans la mesure du possible, cela doit être effectué par le site d’instrumentation, car il existe un contrat entre une logique de Activity demande sortante et la logique de demande en cours sur le site d’instrumentation. Toutefois, le site d’instrumentation ne peut pas gérer la stratégie (par exemple, si les informations d’activité doivent être désactivées ou écrites dans un format antérieur pour des raisons de compatibilité).
Pour cela, le site d’instrumentation doit rappeler le système de journalisation et lui demander de résoudre la stratégie. C’est l’objectif de la OnActivityExport méthode.
La OnActivityExport méthode reçoit le Activity ainsi qu’un objet de charge utile qui représente la requête sortante. Un DiagnosticSource abonné a ensuite la possibilité de mettre à jour la demande sortante avant son envoi.
Notez que cette méthode est rarement utilisée sur les sites d’instrumentation (uniquement les sites qui se trouvent sur une limite sortante du processus). De plus, la stratégie par défaut effectuée par le site d’instrumentation (par exemple, pour transférer tous les états d’activité dans une convention sortante particulière) est susceptible d’être correcte. Cette méthode est uniquement pour les cas où il s’agit d’un problème. Par conséquent, cette méthode doit être utilisée très rarement et est principalement ici pour la symétrie avec OnActivityImport et la vérification de l’avenir.
Notez que payload est tapé comme un Object ici, mais tout site d’instrumentation et abonné particulier doit connaître le type de la charge utile et donc la caster et la décoder si nécessaire.
