DiagnosticSource.OnActivityImport(Activity, Object) Méthode

public:
 virtual void OnActivityImport(System::Diagnostics::Activity ^ activity, System::Object ^ payload);

public virtual void OnActivityImport(System.Diagnostics.Activity activity, object? payload);

public virtual void OnActivityImport(System.Diagnostics.Activity activity, object payload);

abstract member OnActivityImport : System.Diagnostics.Activity * obj -> unit
override this.OnActivityImport : System.Diagnostics.Activity * obj -> unit

Public Overridable Sub OnActivityImport (activity As Activity, payload As Object)

Paramètres

Remarques

Si un site d’instrumentation crée une activité en réponse à un événement en dehors du processus, tel qu’une requête HTTP entrante), la OnActivityImport méthode permet à ce site de créer une activité et de transférer l’état de la requête entrante vers l’activité.

Dans la mesure du possible, cela doit être effectué par le site d’instrumentation, car il existe un contrat entre la Activity logique de requête entrante sur le site d’instrumentation. Toutefois, le site d’instrumentation ne peut pas gérer la stratégie. (Par exemple, si l’échantillonnage est effectué, exactement quelles demandes doivent être échantillonnés ?) Dans ces cas, le site d’instrumentation doit rappeler le système de journalisation et lui demander de résoudre la stratégie (par exemple, pour décider si le bit « échantillonnage » de l’activité doit être défini). Il s’agit de l’objectif de la OnActivityImport méthode. Il reçoit l’activité ainsi qu’un objet de charge utile qui représente la requête entrante. Les abonnés à l’instance DiagnosticSource ont ensuite la possibilité de mettre à jour cette activité comme vous le souhaitez.

Cette méthode est rarement utilisée sur les sites d’instrumentation (seuls les sites situés sur la limite du processus) et le site d’instrumetation implémente une stratégie par défaut (il définit l’activité d’une certaine manière), et il n’est donc pas nécessaire de remplacer cette méthode si cette stratégie par défaut est correcte. En d’autres termes, cette méthode doit être remplacée dans des cas très rares (mais souvent importants).

Notez qu’il payload est tapé comme Object ici, mais tout site d’instrumentation particulier et l’abonné connaîtront le type de la charge utile et le décodent donc si nécessaire.